Docs Index

Last updated: 2026-06-18 Scope: target repo docs entry map Responsibility: tell future agents what to read first and where each kind of project truth belongs Recommended next hop: handoff/latest.md

Target Repo Snapshot

• Current target root: /Users/garytchois/Desktop/self-evolving skill
• Installed workflow source: codex-teammode-workflow/
• Target source tree: TBD after target code audit
• Package/build config: HUMAN_CHECK_REQUIRED. No package.json, lockfile, pyproject.toml, Cargo.toml, go.mod, or Makefile was present during bootstrap.
• Validation commands: HUMAN_CHECK_REQUIRED. Fill these in after the target project code and toolchain are present.

codex-teammode-workflow/ is the workflow package source. Do not treat package-local product examples, plans, evidence, or architecture claims as facts about this target project.

Read Order

Use this order only when project-level context is needed. Normal workflow still starts with current code, then reads docs as needed.

1. handoff/latest.md
2. product/current-state.md
3. architecture/system-map.md
4. architecture/domain-boundaries.md
5. architecture/ia-and-navigation.md
6. workflow/collaboration.md
7. workflow/prompt-template.md
8. workflow/team-loop.md only when Team Loop is explicitly requested; dispatch subagents with workflow/team-loop-core.md and only the matching workflow/team-loop-roles/<role>.md
9. planner/* only for normal-workflow plan-only, read-only audit, prompt framing, or review framing; Team Loop subagents do not read it by default
10. workflow/update-policy.md only when upgrading an older workflow install
11. workflow/docs-maintenance.md
12. product/active-directions.md
13. plans/tech-debt.md
14. plans/active/ and plans/completed/ when a managed plan is in scope
15. handoff/archive/ only for history lookup

Task Routing

• Quick context: read handoff/latest.md, then product/current-state.md.
• System structure, runtime surfaces, or build map: read architecture/system-map.md.
• Navigation, routes, IA, or visible entry points: read architecture/ia-and-navigation.md.
• Risky cross-domain contracts: read architecture/domain-boundaries.md.
• Normal execution workflow: read workflow/collaboration.md, workflow/session-startup.md, and workflow/prompt-template.md.
• Root cause not locked: read root workflow/audit-first.md.
• Normal plan-only, read-only audit, prompt framing, or review framing: read planner/planner-system.md, planner/planner-input-template.md, and planner/planner-output-schema.md as needed.
• Explicit Team Loop: read workflow/team-loop.md, workflow/team-loop-core.md, and the matching role capsule.
• Docs maintenance: read workflow/docs-maintenance.md.
• Workflow upgrade: read workflow/update-policy.md plus package-local codex-teammode-workflow/UPDATE_MANIFEST.md and codex-teammode-workflow/UPDATE_PROMPT.md.

Fact Priority

1. current code
2. topic docs
3. handoff/latest.md
4. handoff/archive/

If docs and current code conflict, current code wins. Update docs only after verifying the target code.

File Responsibilities

• architecture/system-map.md: target repo directory map, runtime/build map, service/data map, and important object relationships.
• architecture/ia-and-navigation.md: visible IA, navigation, routes, chrome, and entry points.
• architecture/domain-boundaries.md: risky contracts that future agents may misread.
• product/current-state.md: accepted current phase, established capabilities, standing contracts, and known non-goals.
• product/active-directions.md: candidate directions, deferred work, and backlog without duplicating current-state.
• workflow/collaboration.md: ordinary workflow, audit order, evidence rules, and Team Loop boundary.
• workflow/session-startup.md: startup checks, git/environment checks, and target validation command placeholders.
• workflow/prompt-template.md: prompt and output skeletons.
• workflow/team-loop.md: explicit-only Leader and subagent workflow.
• workflow/team-loop-core.md: slim Context Bootstrap contract for Team Loop subagents.
• workflow/team-loop-roles/: role capsules for leader, planner, generator, scout, and evaluator.
• workflow/update-policy.md: how to upgrade workflow-owned files without overwriting target-owned facts.
• planner/: normal-workflow schemas and templates.
• ../workflow/audit-first.md: root-level read-only audit and evidence-first mechanism.
• plans/active/: active multi-turn plan artifacts.
• plans/completed/: accepted/completed plan artifacts.
• plans/tech-debt.md: long-lived technical, structural, experience, or process debt.
• handoff/latest.md: short new-thread handoff, not the highest source of truth.
• handoff/archive/: historical handoff snapshots only.
• evidence/: read-only audit evidence and verification notes.

Target Project Notes

TBD after target code audit.