Skip to content

An agentic skills framework & software development methodology that works.

Fix AGENTS.md to be minimal one-liner + explanatory text

Jesse Vincent5831c4dfea30
diff --git a/codex/INSTALL.md b/codex/INSTALL.md
index fea9be767..9a539d961 100644
--- a/codex/INSTALL.md
+++ b/codex/INSTALL.md
@@ -21,34 +21,7 @@ Quick setup to enable superpowers skills in Codex.
## Superpowers System
<EXTREMELY_IMPORTANT>
- You have superpowers.
-
- **RIGHT NOW, immediately run the bootstrap script:**
-
- ```bash
- ~/.codex/superpowers/scripts/superpowers-codex bootstrap
- ```
-
- This single command will:
- - Show you the complete bootstrap instructions
- - List all available skills
- - Auto-load the using-superpowers skill
-
- **Tool paths for ongoing use:**
- - superpowers-codex: ~/.codex/superpowers/scripts/superpowers-codex
-
- **Critical Rules:**
- - Before ANY task, review the skills list (already shown in bootstrap)
- - If a relevant skill exists, you MUST use superpowers-codex use-skill to load it
- - Announce: "I've read the [Skill Name] skill and I'm using it to [purpose]"
- - Skills with checklists require update_plan todos for each item
- - NEVER skip mandatory workflows (brainstorming before coding, TDD, systematic debugging)
-
- **Skills location:**
- - Superpowers skills: ~/.codex/superpowers/skills/
- - Personal skills: ~/.codex/skills/ (override superpowers when names match)
-
- IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.
+ You have superpowers. Superpowers teach you new skills and capabilities. RIGHT NOW run: `~/.codex/superpowers/scripts/superpowers-codex bootstrap` and follow the instructions it returns.
</EXTREMELY_IMPORTANT>
```
diff --git a/codex/superpowers-bootstrap.md b/codex/superpowers-bootstrap.md
index 8ccfb59bc..98ce278d1 100644
--- a/codex/superpowers-bootstrap.md
+++ b/codex/superpowers-bootstrap.md
@@ -19,11 +19,15 @@ When skills reference tools you don't have, substitute your equivalent tools:
- Personal skills override superpowers skills when names match
**Critical Rules:**
-- Before ANY task, check the skills list shown below
+- Before ANY task, review the skills list (shown below)
- If a relevant skill exists, you MUST use `superpowers-codex use-skill` to load it
- Announce: "I've read the [Skill Name] skill and I'm using it to [purpose]"
- Skills with checklists require `update_plan` todos for each item
- NEVER skip mandatory workflows (brainstorming before coding, TDD, systematic debugging)
+**Skills location:**
+- Superpowers skills: ~/.codex/superpowers/skills/
+- Personal skills: ~/.codex/skills/ (override superpowers when names match)
+
IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.
</EXTREMELY_IMPORTANT>
\ No newline at end of file