Home/ai-coding-skills
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Switch create-plan artifacts to ai_plan and enforce gitignore commit

Browse Source
This commit is contained in:
luke
2026-02-09 05:01:28 +00:00
parent aa8a31246a
commit 1ba911c3fb
10 changed files with 71 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
skills/create-plan/codex/SKILL.md
View File

@@ -5,7 +5,7 @@ description: Use when starting a new feature, project, or complex task that need
# Create Plan (Codex)
Create and maintain a local plan folder under `docs/plans/` (or `docs/plan/` if that repository convention is already in use).
Create and maintain a local plan folder under `ai_plan/` at project root.
## Prerequisite Check (MANDATORY)
@@ -40,9 +40,19 @@ If any dependency is missing, stop immediately and return:
- Use writing-plans workflow.
- Break into milestones and bite-sized stories.
### Phase 6: Generate Plan Files (MANDATORY)
### Phase 6: Initialize Local Plan Workspace (MANDATORY)
Create `docs/plans/YYYY-MM-DD-<short-title>/` with all files below:
At project root:
1. Ensure `ai_plan/` exists. Create it if missing.
2. Ensure `.gitignore` contains `/ai_plan/`.
3. If `.gitignore` was changed, commit that change immediately (local commit only).
Recommended commit message:
- `chore(gitignore): ignore ai_plan local planning artifacts`
### Phase 7: Generate Plan Files (MANDATORY)
Create `ai_plan/YYYY-MM-DD-<short-title>/` with all files below:
1. `original-plan.md` - copy of original planner-generated plan.
2. `final-transcript.md` - copy of final planning transcript used to reach approved plan.
3. `milestone-plan.md` - full implementation spec (from template).
@@ -51,10 +61,10 @@ Create `docs/plans/YYYY-MM-DD-<short-title>/` with all files below:
Use templates from this skill's `templates/` folder.
### Phase 7: Handoff
### Phase 8: Handoff
Always instruct the executing agent:
> Read `docs/plans/YYYY-MM-DD-<short-title>/continuation-runbook.md` first, then execute from that folder.
> Read `ai_plan/YYYY-MM-DD-<short-title>/continuation-runbook.md` first, then execute from that folder.
Do not rely on planner-private files during implementation.
@@ -71,11 +81,14 @@ Do not rely on planner-private files during implementation.
## Gitignore Note
If `docs/plans` or `docs/plan` is gitignored, this is expected. Do not treat inability to commit plan-file updates as a problem. These files are local to the user.
`ai_plan/` is intentionally local and must stay gitignored. Do not treat inability to commit plan-file updates in `ai_plan/` as a problem.
## Verification Checklist
- [ ] Plan directory created under `docs/plans/` (or repo-standard `docs/plan/`)
- [ ] `ai_plan/` exists at project root
- [ ] `.gitignore` includes `/ai_plan/`
- [ ] `.gitignore` ignore-rule commit was created if needed
- [ ] Plan directory created under `ai_plan/YYYY-MM-DD-<short-title>/`
- [ ] `original-plan.md` present
- [ ] `final-transcript.md` present
- [ ] `milestone-plan.md` present