Skip to main content

archive-planning

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.

Source facts

Repository
bahayonghang/my-claude-code-settings
Last source activity
June 7, 2026 at 16:23
Detected SKILL.md language
English
Stars
15
Forks
1

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
4 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
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: ```text .plannings/<yyyyMMdd-HHmmss>-<feature-slug>/ ``` Use the bundled script instead of reimplementing the move logic. ## Run From the project root: ```bash python "$SKILL_DIR/scripts/archive_planning.py" "$ARGUMENTS" ``` If `$ARGUMENTS` is empty, omit it: ```bash 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.md` - `findings.md` - `progress.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: 1. first line of `task_plan.md` matching `# 任务计划:xxx` or `# 任务计划: xxx` 2. first valid content line under `## 目标` in `task_plan.md` 3. first valid content line under `## 需求` in `findings.md` 4. 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.
View on GitHub