fix: beta skill naming, plan file suffixes, and promotion checklist

- Beta plans use -beta-plan.md suffix to avoid clobbering stable plans
- Fix internal references in beta skills to use beta names consistently
- Add beta skills section to AGENTS.md with promotion checklist
This commit is contained in:
Trevin Chow
2026-03-17 09:26:15 -07:00
parent ad53d3d657
commit ac53635737
3 changed files with 33 additions and 6 deletions

View File

@@ -224,11 +224,12 @@ Ask the user only when the answer materially affects architecture, scope, sequen
- Draft a clear, searchable title using conventional format such as `feat: Add user authentication` or `fix: Prevent checkout double-submit`
- Determine the plan type: `feat`, `fix`, or `refactor`
- Build the filename following the repository convention: `docs/plans/YYYY-MM-DD-NNN-<type>-<descriptive-name>-plan.md`
- Build the filename following the repository convention: `docs/plans/YYYY-MM-DD-NNN-<type>-<descriptive-name>-beta-plan.md`
- Create `docs/plans/` if it does not exist
- Check existing files for today's date to determine the next sequence number (zero-padded to 3 digits, starting at 001)
- Keep the descriptive name concise (3-5 words) and kebab-cased
- Examples: `2026-01-15-001-feat-user-authentication-flow-plan.md`, `2026-02-03-002-fix-checkout-race-condition-plan.md`
- Append `-beta` before `-plan` to distinguish from stable-generated plans
- Examples: `2026-01-15-001-feat-user-authentication-flow-beta-plan.md`, `2026-02-03-002-fix-checkout-race-condition-beta-plan.md`
- Avoid: missing sequence numbers, vague names like "new-feature", invalid characters (colons, spaces)
#### 3.2 Stakeholder and Impact Awareness
@@ -322,7 +323,7 @@ type: [feat|fix|refactor]
status: active
date: YYYY-MM-DD
origin: docs/brainstorms/YYYY-MM-DD-<topic>-requirements.md # include when planning from a requirements doc
deepened: YYYY-MM-DD # optional, set later by deepen-plan when the plan is substantively strengthened
deepened: YYYY-MM-DD # optional, set later by deepen-plan-beta when the plan is substantively strengthened
---
# [Plan Title]
@@ -494,7 +495,7 @@ If the plan originated from a requirements document, re-read that document and v
Use the Write tool to save the complete plan to:
```text
docs/plans/YYYY-MM-DD-NNN-<type>-<descriptive-name>-plan.md
docs/plans/YYYY-MM-DD-NNN-<type>-<descriptive-name>-beta-plan.md
```
Confirm: