feat: add global system prompt and seed AGENTS templates; update proposal to include meta/ and prompts/global/; add project AGENTS template\n\nchore: update AGENTS.md and dev logs; encode governance/propagation rule

This commit is contained in:
2025-09-17 10:20:49 -05:00
parent ce0a8b32ec
commit 0625682e63
10 changed files with 410 additions and 4 deletions

View File

@@ -11,10 +11,31 @@
- Binary: detect `codex` then `codex-cli`; override `CODEX_BIN`.
- Safety: no overwrites without `--force`; never `git push` for user projects.
- Outputs: `<project>/runs/<ts>/...`.
- Layout (repo): `CodexHelper`, `bin/install.sh`, `prompts/global/system.md`, `modes/<Name>/{mode.md,system.md?,defaults.yaml}`, `templates/project/<Name>/...`.
- Layout (project): `prompts/{project.md,style.md?}`, `prompts/_mode/`, `codex.yaml`, `codex.sh`, `runs/`.
- Layout (repo): `CodexHelper`, `bin/install.sh`, `prompts/global/{system.md,system.llm.md}`, `modes/<Name>/{mode.md,system.md?,defaults.yaml}`, `templates/project/<Name>/...`, `templates/project/_shared/AGENTS.md`, `meta/{AGENTS.seed.md,AGENTS.seed.llm.md}`.
- Layout (project): `AGENTS.md`, `prompts/{project.md,style.md?}`, `prompts/_mode/`, `codex.yaml`, `codex.sh`, `runs/`.
- Governance/Propagation: non-project-specific workflow changes get recorded in `prompts/global/` and seed AGENTS templates; proposal/plan updated so scaffolding includes them.
- Phase 1 acceptance:
- new-mode creates mode skeleton
- new-project scaffolds without overwrites
- run composes and calls detected codex; writes under runs/
- precedence respected; running in repo errors for run/new-project
- new-project copies `templates/project/_shared/AGENTS.md` into project root as `AGENTS.md`
- prompts/global present and used in prompt composition
- governance rule: changes to global norms propagate to prompts/global and AGENTS templates; logged in DevLog
\n+## Approval — Tick All That Apply
- Subcommands approved: `new-project`, `run`, `new-mode` [ ]
- Scope approved: repo→`new-mode` only; outside→`new-project`/`run` [ ]
- Prompts order approved: global→mode-system?→mode→project [ ]
- Config+precedence approved: YAML+yq; CLI>ENV>project>mode>global [ ]
- Safety approved: `--force` to overwrite; no `git push`; outputs to `<project>/runs/<ts>/...` [ ]
- Repo layout approved (modes, templates, global prompts) [ ]
- Project layout approved (prompts, `_mode/`, codex.yaml, codex.sh, .gitignore) [ ]
- Include empty `prompts/style.md` by default [ ]
- Binary discovery: `codex``codex-cli`; override `CODEX_BIN` [ ]
- Pass-through flags: `--mode --prompt-file --config --sandbox --full-auto` [ ]
- Block `run`/`new-project` inside repo with helpful error [ ]
- Phase 1 (Crawl) scope acceptable [ ]
- Add `docs/ROADMAP.md`; MCP deferred [ ]
Final: Reply in the human doc with “Approved for Plan” when all are checked.