Skip to content

1.1 Repository and Monorepo Structure

Sprint: Sprint 01 - Foundation
Feature ID: 1.1
Subtasks: 1.1.1, 1.1.2

Objective

Deliver "Repository and Monorepo Structure" within Sprint 01 - Foundation.

Dependencies

Aggregated from the subtasks below (prerequisite task IDs and enablers):

  • 1.1.1

Subtasks

1.1.1 Initialize repository and top-level layout

  • ID: 1.1.1
  • Title: Initialize Git repository and monorepo directory structure
  • Description: Create the Git repo and the top-level directories: platform/, microservices/, infra/, architecture/adr/, docs/, .github/. Add .gitignore (Java/Maven/IDE/target), .editorconfig, and a root README.md describing the monorepo (ADR-002).
  • Business Purpose: A single versioned source of truth for platform and services (ADR-001/002).
  • Inputs: ADR-001 (repository strategy), ADR-002 (monorepo strategy).
  • Outputs: Git repo with directory skeleton, .gitignore, .editorconfig, root README.md.
  • Acceptance Criteria:
  • git status is clean after initial commit; target/ and IDE files are ignored.
  • All listed top-level directories exist and are tracked (with .gitkeep where empty).
  • Dependencies: none
  • Complexity: S

1.1.2 Define code-ownership and contribution rules

  • ID: 1.1.2
  • Title: Add CODEOWNERS, PR template, and no-emoji contribution rule
  • Description: Add .github/CODEOWNERS, a PR template enforcing ADR references, and a CONTRIBUTING.md codifying ARC-09 (no emojis in code, comments, commits, docs).
  • Business Purpose: Enforce governance and review discipline from commit one.
  • Inputs: CLAUDE.md governance rules.
  • Outputs: CODEOWNERS, PR template, CONTRIBUTING.md.
  • Acceptance Criteria:
  • Opening a PR auto-populates the template.
  • CONTRIBUTING explicitly forbids emojis and references the ADR index.
  • Dependencies: 1.1.1
  • Complexity: S

Acceptance Criteria

Each subtask above carries its own objective, testable acceptance criteria. This feature is complete when every subtask's acceptance criteria are met.

Deliverables

  • Git repo with directory skeleton, .gitignore, .editorconfig, root README.md.
  • CODEOWNERS, PR template, CONTRIBUTING.md.

Definition of Done

  • All subtasks (1.1.1, 1.1.2) completed and their acceptance criteria verified.
  • All listed dependencies satisfied.
  • Build and tests green per the global conventions in ../README.md (Section 3).