perhapsspy/project-context · Archived

project-context-migration

Audit scattered repository docs and notes, then move only the right working context into the `project-context` structure.

First seen Mar 12, 2026

Installation

$ npx skills add perhapsspy/project-context --skill project-context-migration

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from perhapsspy/project-context.

npx skills add perhapsspy/project-context

Browse all from perhapsspy/project-context

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 7
License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,559 B
  • docs SUMMARY.md 154 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 35 installs

SKILL.md

Project Context Migration

Purpose

Audit scattered repository docs and notes before moving the right working context into project-context. Apply the main [project-context contract](../project-context/SKILL.md) first. Use this companion only for existing legacy context, not to initialize an empty repo.

Classification

  • TASK: material that belongs in agent working context but is task-local, historical, exploratory, unresolved, or not trusted as current truth.
  • REFERENCE: current trusted rules, facts, or shared contracts another task can directly reuse.
  • LEAVE: product/user/team docs, human-facing top-level notes, and origin/about/repository narrative that do not belong in agent working context.
  • ARCHIVE: stale duplicates or superseded docs only when cleanup is authorized; it is not a default project-context destination.

LEAVE is a valid result. If membership in agent working context is uncertain, use LEAVE; if membership is clear but current truth or adoption is uncertain, use TASK. Do not promote content to REFERENCE merely because it is technical.

Migration Contract

Inventory candidate sources read-only, then resolve each source or separable part to a classification, currentness, existing owner, target or leave decision, and reason. Persist this map in one dated migration task before rewriting, moving, archiving, or deleting content.

Apply only the resolved map. Preserve existing canonical and human-facing owners; merge overlapping working context into one preferred task or reference owner. Rewrite current reference truth instead of copying timeline noise, and keep comparison detail, rationale, uncertainty, and change trace in the migration task.

Preserve shipped authority and human-facing documents outside project-context. Normalize saved paths to repo-relative paths or stable placeholders. If an item lacks a trustworthy date, use the migration date and record that uncertainty in its task.

Run the main runtime-shape checker, then reconcile the map and spot-review representative or high-risk classifications and owner transitions. Shape success does not prove migration correctness.

Completion

Finish when every inventoried candidate has a disposition, uncertain material remains isolated, human-facing material is preserved, and both destination shape and representative mappings have been checked.