| name | archive-planning |
| description | Archive root-level planning files (`task_plan.md`, `findings.md`, and `progress.md`) into a timestamped `.plannings/` directory for the current feature. Use when Codex should run `$archive-planning [feature-name]`, close out an active plan, preserve completed planning context, or replace the deprecated Codex prompt workflow with a deterministic skill script. |
| version | 0.1.0 |
| category | developer-tools-integrations |
| tags | ["codex","planning","archive","project-state"] |
| argument-hint | [feature-name] |
| allowed-tools | Bash(python *), Bash(py *), Read |
Archive Planning
Archive the three active root planning files into one timestamped local folder:
.plannings/<yyyyMMdd-HHmmss>-<feature-slug>/
Use the bundled script instead of reimplementing the move logic.
Run
From the project root:
python "$SKILL_DIR/scripts/archive_planning.py" "$ARGUMENTS"
If $ARGUMENTS is empty, omit it:
python "$SKILL_DIR/scripts/archive_planning.py"
The script treats the current working directory as the project root.
Behavior contract
- Require all three root files before doing anything:
task_plan.mdfindings.mdprogress.md
- If any file is missing, stop, print every missing file, do not create
.plannings/, and do not move anything.
- If a feature name argument is provided, use it for the archive slug.
- If no feature name is provided, infer it in this order:
- first line of
task_plan.md matching # 任务计划：xxx or # 任务计划: xxx
- first valid content line under
## 目标 in task_plan.md
- first valid content line under
## 需求 in findings.md
- current project root directory name
- Move the three files into the archive directory. Do not copy them and do not leave root copies behind on success.
- Keep the operation scoped to those three files only; never archive nested planning files or unrelated notes.
Output
Success prints the archive directory and moved file list. Failure prints the missing files plus a no-op guarantee.
