IntentGuard

S01.1 — Establish agent governance and repository skeleton

Planning / historicaltaskdelivery

Historical

Planning material. It summarizes and links to the authoritative specification and the current measured state — it does not replace either, and it is not current engineering truth.

Migration identity#

  • Canonical identifier: S01.1 (GitHub issue type: subtask).
  • Legacy identifier: C01.1 (retained as old_identifier).
  • Parent epic: E01.
  • Milestone: M1 — IntentGuard Weekend MVP.

Objective#

Make the root guidance govern every application path and create the approved directory skeleton without ML behavior.

Rationale#

Agents need one authority and safe mutation boundaries before parallel implementation begins.

Parent identifier#

E01.

Source task#

T-001.

Traceability#

Primary: T-001, NFR-007. Secondary: NFR-010.

Prerequisites#

Approved Gate A and authoritative specification present.

Likely files#

AGENTS.md, CLAUDE.md, README.md, LICENSE, .gitignore, .env.example, root directories and tracked README contracts.

Implementation boundary#

Repository instructions and empty structural boundaries only; docs/specification/ stays unchanged.

MUST scope#

FPAT rules, approval gates, mission, strict-MVP/status/evidence rules, architecture constraints, and generated-directory contracts.

Explicit non-goals#

Detailed specification duplication, ML code, Git initialization, remote resources, or optional tooling.

Acceptance criteria#

Root instructions are singular; CLAUDE imports them; required roots exist; generated roots retain only README contracts; MIT text is present.

Validation commands#

uv run python scripts/validate_foundation.py && uv run pytest tests/contract/test_repository_contract.py -q.

Expected evidence#

Validated tree, instruction links, generated-root scan, and specification-location assertion.

Fallback and status consequence#

Missing governance or structure makes U01 Partial and blocks downstream readiness.

Stop condition#

Stop for unexpected existing-file conflicts, specification relocation/duplication, secrets, or unapproved mutation scope.

Definition of ready#

Gate A, license, architecture, and source-of-truth decisions are confirmed.

Definition of done#

All stated files validate and no detailed specification has been copied.

Labels#

type:subtask, priority:MUST, area:foundation

Estimate#

0.25 hour.

Related in repository

Open in full graph →
DOCUMENTED_BYDOCUMENTED_BY — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.md § S01.1 — Establish agent governance and repository skeletonREFERENCESREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.mdREFERENCESREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.mdPART_OF — source: docs/backlog/TRACEABILITY.md § Source tasksPART_OF — source: docs/backlog/TRACEABILITY.md § Source tasksPART_OF — source: docs/backlog/TRACEABILITY.md § Non-functional requirementsREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.md § TraceabilityREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.md § TraceabilityREFERENCES — source: docs/backlog/tasks/C01.1-agent-instructions-skeleton.md § TraceabilityREFERENCES — source: docs/backlog/umbrellas/U01-project-foundation.md § TraceabilityREFERENCES — source: docs/backlog/umbrellas/U01-project-foundation.md § TraceabilityRELATED_TO — source: docs/backlog/umbrellas/U01-project-foundation.md § Migration identityCURRENTdocument: S01.1 — Establish agent governance and repository skeletonS01.1task: S01.1E01epic: E01NFR-007 — Maintainabilityrequirement: NFR-007 — MaintainabilityNFR-010 — Honest reportingrequirement: NFR-010 — Honest reportingT-001 — Locked validated…task: T-001 — Locked validated repository skeletonU01 — Project foundation…capability: U01 — Project foundation and reproducibility
Hover an edge for its provenance · click a node to open it7 nodes · 16 edges