agentleFS
MostAshrafMostAshraf/ai-sdlc-harness/skills/repo-map-refresh/SKILL.md

repo-map-refresh

Skill20 starsChanged 3 months agoMITView on GitHub

Regenerate the auto-generated repo map the planner grounds its plans in. USER-ENTRY — invoke only when the user explicitly runs /repo-map-refresh; never autonomously, never from a subagent (guard-enforced).

The file

Files
SKILL.md

repo-map-refresh

The repo map is a navigation aid, never hand-maintained — corrections go through regeneration (design.md piece 5B). /init-workspace and /add-repo both point here for the identical generate-or-regenerate procedure (step 2 below) — this is the one place it's maintained; don't fork a second copy of it elsewhere.

  1. ${CLAUDE_PLUGIN_ROOT}/bin/harness repo-map-check --repo-name <n> --repo <path> — report missing / fresh / stale (+ commits behind) to the user.
  2. To regenerate: spawn the planner shape with harness-mode: repo-map as the prompt's FIRST line (the spawn guard regex-matches this exact header — prose that merely mentions repo-map does not satisfy it; this is a declared out-of-run spawn, pipeline/surfaces.yaml's out_of_run_spawns, legal regardless of whether other runs exist in the workspace) and the repo path. Prefer run_in_background: false where the Agent tool has that parameter — the reply then flows back through PostToolUse. Where the tool defaults spawns to background or has no such parameter, the launch stub returns immediately and the platform's own completion notification is the ONLY signal: WAIT for it before step 3. Know that the harness cannot track THIS spawn in flight — capture early-returns for out-of-run spawns BEFORE the stub-recognition gate, so a backgrounded repo-map spawn records no spawn-pending, appears nowhere in show's outstanding_spawns, and an agent that dies mid-generation leaves zero trace while you wait. For the correct subagent_type and why a wrong identity is now blocked, see shared/spawn-identity.md — match the frontmatter name: ai-sdlc-planner, never a generic agent. The planner can only write under ai/<run>/ and .claude/context/ (guard-enforced — never repo source), so point it at .claude/context/repo-map/<name>/. It follows the map content contract (${CLAUDE_PLUGIN_ROOT}/skills/dev-workflow/steps/repo-map-task.md): index.md (purpose/stack/modules/cross-repo edges — intake's targeting tier), areas/* detail files (each loadable alone), and conventions.md (observed patterns with cited examples — what plan-review checks plans against).
  3. Stamp it yourself, not the planner: ${CLAUDE_PLUGIN_ROOT}/bin/harness repo-map-stamp --repo-name <n> --repo <path> — stamping is the orchestrator's job, never the planner's own.
  4. Remind the user: the planner still reads real code for areas it plans to touch — the map speeds targeting, it doesn't replace reading.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.