bigpowers 2.72.0 → 2.73.0

package/.pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.72.0",
+  "version": "2.73.0",
   "description": "75 skills — 73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "keywords": [
     "pi-package"

package/.pi/prompts/seed-conventions.md

@@ -29,13 +29,16 @@ Ask the user these questions (one at a time, wait for each answer):
 5. **Conventions** — "Any naming, file organization, or patterns all agents must follow?"
 6. **Never-do list** — "What are the hard stops? Things an agent must never touch?"
 7. **Defensive code categories** — "Which apply? (Rate limit / Retry / Circuit breaker / Timeout / Graceful degradation)"
-8. **Local tool wiring (optional)** — "Wire bigpowers skills for project-local tools that global install can't reach? (Cursor + OpenCode only)" If yes, generate the local wiring artifacts described in [REFERENCE.md](REFERENCE.md) §Local tool wiring. If no, skip — the standard seed output is unchanged.
+8. **Local tool wiring (optional)** — "Wire bigpowers for project-local tools? (Cursor, OpenCode, Cline, Aider, Codex CLI)" If yes, generate AGENTS.md spine artifacts per [REFERENCE.md](REFERENCE.md) §Local tool wiring and §AGENTS.md spine. If no, skip — standard seed output unchanged (no AGENTS.md spine unless opted in).
 
 ## Generate files
 
 After the interview, generate each file using the templates in [REFERENCE.md](REFERENCE.md):
-- `CLAUDE.md`, `GEMINI.md`, `AGENTS.md` — from the agent-config template
-- `opencode.json` — from the opencode template
+- `AGENTS.md` — from `docs/templates/AGENTS.md` Reach Template (canonical spine source)
+- `CLAUDE.md` — symlink to `AGENTS.md` (copy fallback on Windows when symlink fails)
+- `GEMINI.md` — symlink to `AGENTS.md` when Gemini wiring opted in
+- `opencode.json` — with `"instructions": ["AGENTS.md"]` when OpenCode opted in
+- `.aider.conf.yml` — with `read: AGENTS.md` when Aider opted in
 - `CONVENTIONS.md` — bigpowers standard template + project defensive code categories
 
 ### `specs/` directory
@@ -71,15 +74,27 @@ When generating `CLAUDE.md`, if the user did not name a Preflight command, chain
 
 ---
 
-# story: e51s02
+# story: e51s02 e37s01 e37s03 e37s14
 # Seed Conventions — Reference Templates
 
-## Agent config template (CLAUDE.md / GEMINI.md / AGENTS.md)
+## AGENTS.md spine (Reach Template — e37s01)
+
+Canonical source: copy from `docs/templates/AGENTS.md` in the bigpowers repo (Reach Template).
+Do not invent structure ad hoc — the template includes multi-agent preamble, Preflight, Test/Lint/Build sections.
+
+When local tool wiring is opted in:
+1. Copy Reach Template → project root `AGENTS.md`, fill interview placeholders
+2. `ln -sf AGENTS.md CLAUDE.md` (or content copy on Windows when symlink fails)
+3. Write `opencode.json` with `"instructions": ["AGENTS.md"]`
+
+When user **opts out** of local tool wiring, do not emit AGENTS.md spine artifacts.
+
+## Agent config template (legacy — prefer AGENTS.md spine)
 
 All three files use the same structure — only the header differs:
-- `CLAUDE.md` → `# [Project Name] — Claude Code`
+- `CLAUDE.md` → `# [Project Name] — Claude Code` (or symlink to AGENTS.md)
 - `GEMINI.md` → `# [Project Name] — Gemini CLI`
-- `AGENTS.md` → `# [Project Name] — OpenCode`
+- `AGENTS.md` → `# [Project Name] — AI Agents` (Reach Template header)
 
 ```markdown
 # [Project Name] — [Agent]
@@ -128,10 +143,33 @@ Stack: [language, framework, runtime]
 ```json
 {
   "$schema": "https://opencode.ai/config.json",
-  "instructions": [".cursor/rules/*.mdc"]
+  "instructions": ["AGENTS.md"]
 }
 ```
 
+## Aider — `.aider.conf.yml` bridge (e37s03)
+
+When Aider wiring is opted in:
+
+```yaml
+read: AGENTS.md
+```
+
+Upstream: [Aider-AI/aider](https://github.com/Aider-AI/aider) (not paul-gauthier/aider).
+
+## Codex CLI — project-local `.codex/config.toml` + AGENTS.md (e37s14)
+
+Source: https://developers.openai.com/codex/guides/agents-md
+
+Codex is instruction-file-only — no slash skills. When Codex wiring is opted in:
+
+```toml
+# .codex/config.toml
+instructions = ["AGENTS.md"]
+```
+
+Use AGENTS.md header `# [Project Name] — AI Agents` (shared with OpenCode/Cline). Single AGENTS.md serves dual-tool projects.
+
 ## CONVENTIONS.md
 
 Use the standard bigpowers CONVENTIONS.md as the base. Fill in the project-specific defensive code categories from the interview answers.

package/.pi/prompts/using-bigpowers.md

@@ -17,9 +17,9 @@ npm install -g bigpowers       # global install
 bigpowers setup                # sync skills + link to your tools
 ```
 
-From source (contributors): `git clone` → `npm install` or `bash scripts/install.sh`.
+From source: `git clone` → `bash scripts/install.sh`. Package: [bigpowers on npm](https://www.npmjs.com/package/bigpowers).
 
-Package: [bigpowers on npm](https://www.npmjs.com/package/bigpowers)
+**Reach tools:** **Cline** — native AGENTS.md reader (no extension). **Aider** — opt-in `.aider.conf.yml` with `read: AGENTS.md` ([Aider-AI/aider](https://github.com/Aider-AI/aider)). **Codex CLI** — optional `.codex/config.toml` via seed-conventions; global `~/.codex/AGENTS.md` from install.sh.
 
 ## What bigpowers is
 

package/.pi/skills/seed-conventions/SKILL.md

@@ -31,13 +31,16 @@ Ask the user these questions (one at a time, wait for each answer):
 5. **Conventions** — "Any naming, file organization, or patterns all agents must follow?"
 6. **Never-do list** — "What are the hard stops? Things an agent must never touch?"
 7. **Defensive code categories** — "Which apply? (Rate limit / Retry / Circuit breaker / Timeout / Graceful degradation)"
-8. **Local tool wiring (optional)** — "Wire bigpowers skills for project-local tools that global install can't reach? (Cursor + OpenCode only)" If yes, generate the local wiring artifacts described in [REFERENCE.md](REFERENCE.md) §Local tool wiring. If no, skip — the standard seed output is unchanged.
+8. **Local tool wiring (optional)** — "Wire bigpowers for project-local tools? (Cursor, OpenCode, Cline, Aider, Codex CLI)" If yes, generate AGENTS.md spine artifacts per [REFERENCE.md](REFERENCE.md) §Local tool wiring and §AGENTS.md spine. If no, skip — standard seed output unchanged (no AGENTS.md spine unless opted in).
 
 ## Generate files
 
 After the interview, generate each file using the templates in [REFERENCE.md](REFERENCE.md):
-- `CLAUDE.md`, `GEMINI.md`, `AGENTS.md` — from the agent-config template
-- `opencode.json` — from the opencode template
+- `AGENTS.md` — from `docs/templates/AGENTS.md` Reach Template (canonical spine source)
+- `CLAUDE.md` — symlink to `AGENTS.md` (copy fallback on Windows when symlink fails)
+- `GEMINI.md` — symlink to `AGENTS.md` when Gemini wiring opted in
+- `opencode.json` — with `"instructions": ["AGENTS.md"]` when OpenCode opted in
+- `.aider.conf.yml` — with `read: AGENTS.md` when Aider opted in
 - `CONVENTIONS.md` — bigpowers standard template + project defensive code categories
 
 ### `specs/` directory
@@ -73,15 +76,27 @@ When generating `CLAUDE.md`, if the user did not name a Preflight command, chain
 
 ---
 
-# story: e51s02
+# story: e51s02 e37s01 e37s03 e37s14
 # Seed Conventions — Reference Templates
 
-## Agent config template (CLAUDE.md / GEMINI.md / AGENTS.md)
+## AGENTS.md spine (Reach Template — e37s01)
+
+Canonical source: copy from `docs/templates/AGENTS.md` in the bigpowers repo (Reach Template).
+Do not invent structure ad hoc — the template includes multi-agent preamble, Preflight, Test/Lint/Build sections.
+
+When local tool wiring is opted in:
+1. Copy Reach Template → project root `AGENTS.md`, fill interview placeholders
+2. `ln -sf AGENTS.md CLAUDE.md` (or content copy on Windows when symlink fails)
+3. Write `opencode.json` with `"instructions": ["AGENTS.md"]`
+
+When user **opts out** of local tool wiring, do not emit AGENTS.md spine artifacts.
+
+## Agent config template (legacy — prefer AGENTS.md spine)
 
 All three files use the same structure — only the header differs:
-- `CLAUDE.md` → `# [Project Name] — Claude Code`
+- `CLAUDE.md` → `# [Project Name] — Claude Code` (or symlink to AGENTS.md)
 - `GEMINI.md` → `# [Project Name] — Gemini CLI`
-- `AGENTS.md` → `# [Project Name] — OpenCode`
+- `AGENTS.md` → `# [Project Name] — AI Agents` (Reach Template header)
 
 ```markdown
 # [Project Name] — [Agent]
@@ -130,10 +145,33 @@ Stack: [language, framework, runtime]
 ```json
 {
   "$schema": "https://opencode.ai/config.json",
-  "instructions": [".cursor/rules/*.mdc"]
+  "instructions": ["AGENTS.md"]
 }
 ```
 
+## Aider — `.aider.conf.yml` bridge (e37s03)
+
+When Aider wiring is opted in:
+
+```yaml
+read: AGENTS.md
+```
+
+Upstream: [Aider-AI/aider](https://github.com/Aider-AI/aider) (not paul-gauthier/aider).
+
+## Codex CLI — project-local `.codex/config.toml` + AGENTS.md (e37s14)
+
+Source: https://developers.openai.com/codex/guides/agents-md
+
+Codex is instruction-file-only — no slash skills. When Codex wiring is opted in:
+
+```toml
+# .codex/config.toml
+instructions = ["AGENTS.md"]
+```
+
+Use AGENTS.md header `# [Project Name] — AI Agents` (shared with OpenCode/Cline). Single AGENTS.md serves dual-tool projects.
+
 ## CONVENTIONS.md
 
 Use the standard bigpowers CONVENTIONS.md as the base. Fill in the project-specific defensive code categories from the interview answers.

package/.pi/skills/using-bigpowers/SKILL.md

@@ -19,9 +19,9 @@ npm install -g bigpowers       # global install
 bigpowers setup                # sync skills + link to your tools
 ```
 
-From source (contributors): `git clone` → `npm install` or `bash scripts/install.sh`.
+From source: `git clone` → `bash scripts/install.sh`. Package: [bigpowers on npm](https://www.npmjs.com/package/bigpowers).
 
-Package: [bigpowers on npm](https://www.npmjs.com/package/bigpowers)
+**Reach tools:** **Cline** — native AGENTS.md reader (no extension). **Aider** — opt-in `.aider.conf.yml` with `read: AGENTS.md` ([Aider-AI/aider](https://github.com/Aider-AI/aider)). **Codex CLI** — optional `.codex/config.toml` via seed-conventions; global `~/.codex/AGENTS.md` from install.sh.
 
 ## What bigpowers is