mcpField
A
archive

archive

github.com/camachoAgent workflows710 installs
Repository

About archive

An agent skill that archives a completed work plan by recording outcomes and learnings, renaming the plan, and committing the change. It is intended for repository workflows that keep plans under ai-workspace/plans/.

Key features

  1. 01Find the latest active plan
  2. 02Record outcomes and learnings
  3. 03Rename the plan as completed
  4. 04Commit the archived plan

Use cases

  1. 01Archiving a finished implementation plan
  2. 02Capturing lessons after project work
  3. 03Keeping a repository plan history

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/camacho/ai-skills --skill archive

After installing, type/archivein Claude Code to confirm it loaded.

Details

From the project README

Inputs

  • WORKTREE: absolute path to current worktree (resolve from session CWD or git rev-parse --show-toplevel)
  • Plan file path (default: most recent non-.done.md in $WORKTREE/ai-workspace/plans/)

Steps

  1. Find the plan file:

    ls -t "$WORKTREE/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1

    If plan is already .done.md → error: "Already archived."

  2. Read the plan file to understand what was planned.

  3. Gather outcomes: Ask the user (or infer from git log + branch context):

    • What worked well?
    • What didn't go as planned?
    • What would you do differently?

    If user skips → write "Outcomes: not recorded" (don't block).

  4. Write Outcomes & Learnings section to the plan file:

    ## Outcomes & Learnings

**Completed**: [date]

### What Worked
- [bullet points]

### What Didn't
- [bullet points]

### Learnings
- [bullet points]

  5. Rename to .done.md:

    git -C "$WORKTREE" mv ai-workspace/plans/<name>.md ai-workspace/plans/<name>.done.md

  6. Commit the archive:

    git -C "$WORKTREE" add ai-workspace/plans/<name>.done.md
git -C "$WORKTREE" commit -m "docs: archive plan <name>

Co-Authored-By: Claude <model>"

Output: Confirmation that the plan is archived with path to .done.md file.

Comments

Markdown supported