chore: add collab/ structure; move questions; add AGENTS.md; addendum in SeedPrompt.md
This commit is contained in:
35
AGENTS.md
Normal file
35
AGENTS.md
Normal file
@@ -0,0 +1,35 @@
|
||||
# AGENTS.md — Working Agreements and Conventions
|
||||
|
||||
Scope: Applies to the entire repository unless overridden by a deeper AGENTS.md.
|
||||
|
||||
## Collaboration Artifacts
|
||||
- Directory: `collab/`
|
||||
- Naming: `<step-or-subject>-<type>.md`
|
||||
- Examples: `00-bootstrap-questions.md`, `01-wrapper-proposal.md`, `01-wrapper-plan.md`
|
||||
- Types: `questions`, `proposal`, `plan`
|
||||
- Principle: Keep chat minimal; prefer file-based collaboration via these documents.
|
||||
|
||||
## Logs and Documentation
|
||||
- Dev logs: `devlog/DEVLOG_LLM.md` and `devlog/DEVLOG_HUMAN.md` updated each meaningful change.
|
||||
- Project docs: `docs/` for feature docs (`<feature>.md`) and architectural decisions (`adr-<feature>.md`).
|
||||
- README: Keep `README.md` current with quickstart and usage.
|
||||
|
||||
## Code and Tests
|
||||
- Add unit tests in `tests/` alongside features as they are introduced.
|
||||
- Keep changes minimal and focused. Avoid unrelated refactors.
|
||||
|
||||
## Git Workflow
|
||||
- Branch: work on `main` for now.
|
||||
- Commits: concise, present-tense; Conventional Commits style preferred (e.g., `feat:`, `fix:`, `chore:`).
|
||||
- Releases/Tags: `YYYY-MM-DD-HHMM` when warranted; use `tea` if configured.
|
||||
|
||||
## Wrapper Project Guidelines
|
||||
- Aim: Bash wrapper around `codex-cli` with modes (global prompt, mode prompt, project prompt, codex settings, MCP).
|
||||
- Approach: crawl → walk → run. Start with documented defaults and override via flags/env/config.
|
||||
- Wizards: Intake markdown forms for creating modes and projects.
|
||||
|
||||
## Agent Notes
|
||||
- Ask clarifying questions in `collab/<...>-questions.md`.
|
||||
- Propose in `collab/<...>-proposal.md`, plan in `collab/<...>-plan.md`, then implement.
|
||||
- Respect repository structure and this AGENTS.md across all changes.
|
||||
|
Reference in New Issue
Block a user