这是一篇由原始材料转换而来的阅读页，保留了源文件的主要结构，并补充了可追溯的来源说明与链接。

Framework 1 — Agent-First Product Delivery

Use this when building a new product or major product area primarily through Codex.

Intent

Turn the repository into a self-describing, agent-operable system where Codex can: - read the map - start the app - inspect behavior - make a bounded change - verify the change - open or prepare a reviewable PR-sized increment

Core components

• AGENTS.md as map
• docs/index.md as knowledge root
• plans/active/*.md for complex work
• feature_list.json for user-visible completeness
• init.sh for repeatable startup + smoke
• browser automation + screenshots for UI verification
• local logs/metrics/traces readable by the agent

Recommended repository additions

• docs/architecture/overview.md
• docs/product/user-journeys.md
• docs/runbooks/local-dev.md
• plans/templates/exec-plan.md
• scripts/smoke.sh
• scripts/verify-pr.sh

Typical loop

1. Read docs map and active plan
2. Start isolated environment (prefer worktree if available)
3. Reproduce or verify baseline behavior
4. Implement one coherent increment
5. Verify via tests + browser + logs
6. Update plan and progress log
7. Commit

Best fit

• greenfield app
• fast product iteration
• repos where humans want to stay above the code-writing layer