map-system

Create or refresh a status-aware system map indexing repos, capabilities, flows, and boundaries.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/toderian/project_template --skill map-system-toderian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-system
Source: https://github.com/toderian/project_template/tree/main/plugins/agents-tasks/skills/map-system
Command: npx skills add https://github.com/toderian/project_template --skill map-system-toderian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams working across multiple repositories lose track of how repos, capability areas, and cross-repo flows fit together, especially after teammates change code or docs. This Skill builds and maintains a single status-aware index so architecture knowledge stays current and evidence-backed. ## Core Features & Use Cases - System Map Generation: Creates or refreshes docs/resources/system-map.md covering participant repos, capability areas, critical flows, cross-repo boundaries, drift signals, and open questions. - Lifecycle Status Tracking: Labels every repo, area, flow, and boundary as draft, accepted, partially-implemented, implemented, or superseded, with evidence required for implemented claims. - Drift Detection: Runs focused refresh passes after teammate changes, reconciling the map against task history, contracts, and execution logs. - Use Case: After a teammate merges changes across three services, ask for a drift check to update the system map, flag stale area docs, and record open questions for follow-up tasks. ## Quick Start Ask the agent to map the system and refresh docs/resources/system-map.md for all configured repos.

Frequently Asked Questions about map-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a system map for multiple repositories?

Run the map-system skill to generate docs/resources/system-map.md indexing participant repos, capability areas, critical flows, and cross-repo boundaries. It validates the repo registry with at repos-check and gathers evidence from area summaries, contracts, and manifests.

How to track architecture drift after teammates change code?

Run a drift check scope, which inspects recent task completion harvests, execution logs, and changed docs, then updates drift signals and open questions in the system map. Stale or missing area docs are reported rather than silently expanded.

What lifecycle statuses does the system map use?

The map uses draft, accepted, partially-implemented, implemented, and superseded. An area, flow, or boundary can only be marked implemented with cited evidence from code, tests, task history, or reviewed docs.

Can the system map reference local checkout paths?

No. Committed docs use stable repo slugs in the form repo-slug:repo-relative-path. Local checkout paths live in .local/repos.map, which is never committed or cited directly.

When should I not expand the system map?

Do not expand it into a full architecture document when detailed area docs are missing or stale. Instead record an open question or recommend the define-area or refresh-context skills, keeping the map an index rather than a duplicate manual.