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:
38
templates/project/_shared/AGENTS.md
Normal file
38
templates/project/_shared/AGENTS.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# AGENTS.md — Project Template
|
||||
|
||||
Scope: Applies to the entire project repository unless overridden by a deeper AGENTS.md.
|
||||
|
||||
This file is copied by scaffolding into new projects. Edit to suit the project while keeping the one-way collaboration flow and file-first practices.
|
||||
|
||||
## Collaboration Artifacts
|
||||
- Root: `collab/`
|
||||
- Subdirectories: `collab/questions/`, `collab/proposals/`, `collab/plan/`
|
||||
- Naming per round: `NN-<subject>.md` (+ `.llm.md` sibling)
|
||||
- One-way sequence: Questions → Proposal → Plan → Implement; no backsteps after approval
|
||||
- Agent reads `.llm.md`; humans edit `.md`. Agent writes both siblings.
|
||||
|
||||
## Logs and Docs
|
||||
- `docs/devlog/DEVLOG_LLM.md` and `docs/devlog/DEVLOG_HUMAN.md` — update each meaningful change.
|
||||
- `docs/` for feature docs and ADRs.
|
||||
- Keep `README.md` current.
|
||||
|
||||
## Chat Output Policy
|
||||
- Default: `Updated <filepath>. Read/edit and let me know.`
|
||||
- Keep chat ≤5 lines; no diffs; announce only collab file changes; log details in DevLog.
|
||||
|
||||
## Coding, Tests, and Git
|
||||
- Minimal, focused changes; add tests with features; consistent style.
|
||||
- Conventional Commits; branch `main`; tags `YYYY-MM-DD-HHMM` when warranted.
|
||||
|
||||
## Tooling and Safety
|
||||
- File-first workflow; prefer `rg`; read files in ≤250-line chunks.
|
||||
- Respect sandbox/approvals; avoid destructive actions without confirmation.
|
||||
- Provide brief preambles before grouped/long-running commands.
|
||||
|
||||
## Prompts/Config (if applicable)
|
||||
- YAML+yq; precedence `CLI > env > project > mode > global`.
|
||||
- Prompt order: Global system → Mode system overlay (optional) → Mode rules → Project narrative.
|
||||
- Outputs: `<project>/runs/<timestamp>/...`; require `--force` for overwrites; never `git push`.
|
||||
|
||||
## Governance and Propagation
|
||||
- When you adopt a reusable, non-project-specific practice, reflect it in your project’s system prompt and AGENTS.md to keep them aligned. Log such changes in `docs/devlog/`.
|
Reference in New Issue
Block a user