FILE_INDEX.md

File Index

This file helps people and agents find the right files quickly.

Root Files

• PROJECT_FORM.md: the user-owned project brief
• PROJECT_FORM_EXAMPLE.md: an example project brief
• PROJECT_STATE.md: the agent-owned project state
• RUN_PROMPT.md: the repeated execution prompt
• README.md: user-facing template overview
• AGENTS.md: shared operating rules
• CLAUDE.md: Claude-specific entry file
• Taskfile.yml: repeated command entrypoints
• .gitignore: ignore rules for temporary files

Knowledge And Guidance

• docs/ARCHITECTURE.md: repository design intent
• docs/WORKFLOW.md: default work flow
• docs/DECISIONS/: structural decision records
• docs/GUIDES/: practical how-to guides

Generic Work Management

• work/INDEX.md: status index for generic work
• work/<status>/YYYY-MM-DD_<task_slug>/: one generic work unit
• templates/work_item/: generic work template
• scripts/workctl.py: create, move, validate, and sync generic work

Experiment Management

• experiments/README.md: experiment area guide
• templates/experiment_workflow_template.md: experiment documentation template
• scripts/expctl.py: create, move, and validate experiments

Shared Assets

• configs/: shared config
• results/: shared results
• logs/: shared logs
• reports/: formal reports
• publish/: publish-ready assets
• notes/: notes and interpretation
• scratch/: throwaway workspace

Tool-Specific Integration

• .claude/agents/: Claude Code project subagents
• .github/: issue and PR templates for team sharing
• AGENTS.md: main scoped guidance file for Codex-style tools