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:
11
meta/AGENTS.seed.llm.md
Normal file
11
meta/AGENTS.seed.llm.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# AGENTS (Seed, LLM)
|
||||
|
||||
- One-way workflow: questions → proposal → plan → implement; no backsteps after approval.
|
||||
- Read `.llm.md` only; write both `.md` and `.llm.md` siblings for collab artifacts.
|
||||
- Chat ≤5 lines; default “Updated <filepath>…”; no diffs; announce only collab file changes; log details in `docs/devlog/`.
|
||||
- Keep changes minimal and focused; add tests with features; consistent style.
|
||||
- Git: Conventional Commits; branch `main`; optional tags `YYYY-MM-DD-HHMM`.
|
||||
- Tools: file-first; use `rg`; read ≤250 lines; respect sandbox/approvals; preface grouped commands.
|
||||
- Prompts/config (if applicable): YAML+yq; precedence CLI>ENV>project>mode>global; prompts order global→mode-system?→mode→project; outputs to `runs/<ts>/`; `--force` to overwrite; never `git push`.
|
||||
|
||||
- Governance: For reusable rules, update system prompt and AGENTS templates; keep them aligned; log in DevLog.
|
61
meta/AGENTS.seed.md
Normal file
61
meta/AGENTS.seed.md
Normal file
@@ -0,0 +1,61 @@
|
||||
# AGENTS.md — Seed Template (For New Projects)
|
||||
|
||||
Scope: Applies to the entire project repository unless overridden by a deeper AGENTS.md.
|
||||
|
||||
Note: This is a template copied into generated projects. Customize as needed for your project. Keep this AGENTS.md aligned with your system prompt and collaboration norms.
|
||||
|
||||
## Collaboration Artifacts
|
||||
- Root: `collab/`
|
||||
- Subdirectories: `collab/questions/`, `collab/proposals/`, `collab/plan/`
|
||||
- Naming per round: `NN-<subject>.md` (e.g., `00-bootstrap.md`, `01-feature.md`).
|
||||
- LLM-optimized copies: add `.llm.md` siblings (machine-friendly).
|
||||
- Versioning: start a new numbered file for major rounds; do not grow one file indefinitely.
|
||||
- Principle: Keep chat minimal; prefer file-based collaboration via these docs.
|
||||
|
||||
### Sequencing Rules (One-Way)
|
||||
- Start with questions; after approval, proceed to proposal; after approval, proceed to plan; then implement.
|
||||
- Once a step is approved, never return to a prior step. Perform edits within the current step’s file for that round and only create the next step’s file when moving forward.
|
||||
- The agent reads `.llm.md` files; humans edit `.md`. The agent writes both `.md` and `.llm.md` siblings.
|
||||
|
||||
## Logs and Documentation
|
||||
- Dev logs: `docs/devlog/DEVLOG_LLM.md` and `docs/devlog/DEVLOG_HUMAN.md` — add an entry for each meaningful change.
|
||||
- Project docs: `docs/` for feature docs (`<feature>.md`) and architectural decisions (`adr-<feature>.md`).
|
||||
- Keep `README.md` current with quickstart and usage.
|
||||
|
||||
## Code and Tests
|
||||
- Keep changes minimal and focused; avoid unrelated refactors.
|
||||
- Add unit tests in `tests/` alongside features.
|
||||
- Maintain consistent style with the existing codebase.
|
||||
|
||||
## Git Workflow
|
||||
- Branch: `main` (unless project policy differs).
|
||||
- Commits: concise, present-tense; Conventional Commits style (`feat:`, `fix:`, `chore:`).
|
||||
- Releases/Tags: `YYYY-MM-DD-HHMM` when warranted.
|
||||
|
||||
## Chat Output Policy
|
||||
- Default message: `Updated <filepath>. Read/edit and let me know.`
|
||||
- Keep chat ≤5 lines; no diffs or large pastes.
|
||||
- Only announce changes to collaboration files in `collab/`; log details in DevLog.
|
||||
|
||||
## Tooling and Safety
|
||||
- Use filesystem-first workflow; prefer `rg` for search; read files in ≤250-line chunks.
|
||||
- Respect sandbox/approval constraints; avoid destructive actions without confirmation.
|
||||
- Provide a short preamble before grouped/long-running tool calls.
|
||||
|
||||
## Prompts/Configuration (if applicable)
|
||||
- If using a wrapper like CodexHelper: YAML config preferred; precedence `CLI > env > project > mode > global`.
|
||||
- Prompt composition order: Global system → Mode system overlay (optional) → Mode rules → Project narrative.
|
||||
- Outputs: write run artifacts to `<project>/runs/<timestamp>/...`.
|
||||
- Safety: do not overwrite without `--force`; never `git push` on behalf of users.
|
||||
|
||||
## Token/Context Hygiene
|
||||
- Keep chat minimal; rely on files and dev logs.
|
||||
- Avoid re-reading large files in chat; reference exact file paths.
|
||||
|
||||
## Governance and Propagation
|
||||
- When introducing non-project-specific collaboration or workflow rules, mirror them in your project’s system prompt and this AGENTS.md template so they persist across projects.
|
||||
- Keep AGENTS.md aligned with your system prompt; log such changes in `docs/devlog/`.
|
||||
|
||||
---
|
||||
|
||||
Customize this AGENTS.md to fit your project specifics while preserving the one-way collaboration flow and file-first practices.
|
Reference in New Issue
Block a user