Project Map Catalog
Catalog exactly one project capability into .wingman/project-map/ with evidence. The project map is an AI-readable capability map, not a source dump and not the final source of truth.
Core Rule
Write one evidence-backed project-map entry and its indexes. Do not catalog from filenames, path names, or guesses.
Gate
Continue only when there is a coherent capability to record. If the user asks to explain, edit, review, or summarize code without asking to record project-map knowledge, do not use this skill.
Core Concepts
A project-map entry is one Markdown file under .wingman/project-map/. It records a capability, flow, surface, component, module, utility, pattern, contract, domain, or term mapping that future agents may need to locate, understand, verify, reuse, extend, wrap, reference, avoid, or replace.
Use fixed English section headings for stable parsing. Write entry content and final responses in the configured memory language when known; otherwise follow the user's current language.
Project Map Layout
Initialize missing directories and indexes as needed:
.wingman/project-map/
README.md
index.md
glossary/index.md
features/index.md
flows/index.md
surfaces/index.md
components/index.md
modules/index.md
utilities/index.md
patterns/index.md
contracts/index.md
domains/index.md
relationships/index.md # optional/future; do not require it for every catalog action
Top-level and section indexes are short routing tables. Use Entry Path, not Entry, as the path column label.
Workflow
Identify the target.
- If the user gave a path, use it as the evidence starting point.
- If the user gave a feature or concept name, search source/docs/routes/tests/schema for evidence.
- If the user said "this feature", use active context and recent relevant files.
- Process exactly one coherent capability per invocation.
Choose the kind.
- Use
feature, flow, surface, component, module, utility, pattern, contract, domain, or glossary-term.
- If uncertain, read
references/kind-selection.md.
Read evidence before writing.
- Read source, docs, routes, schema, tests, generated types, config, or explicit user-confirmed context.
- For source-backed
feature, flow, surface, module, and contract entries, prefer at least two evidence types when available.
- For
component and utility, one primary source file is acceptable, but check usages before claiming reuse scope.
- Do not infer behavior from filename or path alone.
Read existing map context.
- Read
.wingman/project-map/index.md when it exists.
- Read the relevant section index.
- Search
.wingman/project-map/**/*.md for the same source path, same capability name, same tags, or same term.
Decide create/update/replace.
- Same source or same semantic capability: update the existing entry.
- Same name but different responsibility: create a distinct entry and link it in
Related Entries or Similar Features.
- Stale or superseded entry: mark
Legacy or Deprecated, and point to replacement when known.
Write the entry.
- Read
references/entry-templates.md before creating or substantially changing an entry.
- Do not write generic source summaries.
- Do not omit
Last Verified, Evidence Level, Use When, Do Not Use When, or Notes For Agents.
- Use
Unknown rather than inventing facts.
Update indexes.
- Update
.wingman/project-map/index.md.
- Update the relevant section
index.md.
- Update
glossary/index.md only when there is a useful user-language to code-language mapping.
- Update
relationships/index.md only when it already exists or when a clear cross-entry relationship is important. First version may rely on each entry's Related Entries.
References
- Read
references/kind-selection.md only when kind choice is ambiguous.
- Read
references/entry-templates.md before creating or substantially changing an entry.
- Do not read all references by default if updating only an index row or correcting a small typo.
Ask The User When
- The target capability cannot be identified from paths, active context, source search, docs, or user wording.
- Two possible kinds would produce materially different entries and evidence does not settle the choice.
- Writing the entry would require treating an inferred business meaning as confirmed fact.
Safety Rules
- Do not create or update multiple unrelated entries in one invocation.
- Do not write "possible" or "likely" as fact.
- Do not bulk-generate low-signal entries to cover a whole repository.
- Do not overwrite user-authored
Notes For Agents, Use When, Do Not Use When, or status unless evidence or explicit user instruction proves they are outdated.
- If project memory current truth conflicts with a project-map entry, keep memory truth authoritative and mark the map entry as needing update.
- Do not migrate
.wingman/registry/ automatically. Treat old registry files as non-authoritative historical hints unless the user asks for migration.
Final Response
Report concisely:
- entry name and kind
- entry path
- status and evidence level
- updated indexes
- key tags or search hints
- any unverified gaps
Checklist
Before finishing, verify:
1---2name: project-map-catalog3description: Use when recording, registering, or updating a project feature, flow, page, component, module, utility, pattern, contract, domain, or business concept into Wingman's project map for future discovery and reuse/reference decisions. Trigger for 登记, 记录, 加入项目地图, 以后 AI 能找到, catalog, register, record, add to project map, feature inventory, capability map, or reusable capability. Do not use for explaining code, editing code, summarizing a file, or writing memory/history unless the user asks to add project-map knowledge.4metadata:5 source: https://skillmd.com/skills/hashgraph-online/project-map-catalog6---78# Project Map Catalog910Catalog exactly one project capability into `.wingman/project-map/` with evidence. The project map is an AI-readable capability map, not a source dump and not the final source of truth.1112## Core Rule1314Write one evidence-backed project-map entry and its indexes. Do not catalog from filenames, path names, or guesses.1516## Gate1718Continue only when there is a coherent capability to record. If the user asks to explain, edit, review, or summarize code without asking to record project-map knowledge, do not use this skill.1920## Core Concepts2122A project-map entry is one Markdown file under `.wingman/project-map/`. It records a capability, flow, surface, component, module, utility, pattern, contract, domain, or term mapping that future agents may need to locate, understand, verify, reuse, extend, wrap, reference, avoid, or replace.2324Use fixed English section headings for stable parsing. Write entry content and final responses in the configured memory language when known; otherwise follow the user's current language.2526## Project Map Layout2728Initialize missing directories and indexes as needed:2930```text31.wingman/project-map/32 README.md33 index.md34 glossary/index.md35 features/index.md36 flows/index.md37 surfaces/index.md38 components/index.md39 modules/index.md40 utilities/index.md41 patterns/index.md42 contracts/index.md43 domains/index.md44 relationships/index.md # optional/future; do not require it for every catalog action45```4647Top-level and section indexes are short routing tables. Use `Entry Path`, not `Entry`, as the path column label.4849## Workflow50511. Identify the target.52 - If the user gave a path, use it as the evidence starting point.53 - If the user gave a feature or concept name, search source/docs/routes/tests/schema for evidence.54 - If the user said "this feature", use active context and recent relevant files.55 - Process exactly one coherent capability per invocation.56572. Choose the kind.58 - Use `feature`, `flow`, `surface`, `component`, `module`, `utility`, `pattern`, `contract`, `domain`, or `glossary-term`.59 - If uncertain, read `references/kind-selection.md`.60613. Read evidence before writing.62 - Read source, docs, routes, schema, tests, generated types, config, or explicit user-confirmed context.63 - For source-backed `feature`, `flow`, `surface`, `module`, and `contract` entries, prefer at least two evidence types when available.64 - For `component` and `utility`, one primary source file is acceptable, but check usages before claiming reuse scope.65 - Do not infer behavior from filename or path alone.66674. Read existing map context.68 - Read `.wingman/project-map/index.md` when it exists.69 - Read the relevant section index.70 - Search `.wingman/project-map/**/*.md` for the same source path, same capability name, same tags, or same term.71725. Decide create/update/replace.73 - Same source or same semantic capability: update the existing entry.74 - Same name but different responsibility: create a distinct entry and link it in `Related Entries` or `Similar Features`.75 - Stale or superseded entry: mark `Legacy` or `Deprecated`, and point to replacement when known.76776. Write the entry.78 - Read `references/entry-templates.md` before creating or substantially changing an entry.79 - Do not write generic source summaries.80 - Do not omit `Last Verified`, `Evidence Level`, `Use When`, `Do Not Use When`, or `Notes For Agents`.81 - Use `Unknown` rather than inventing facts.82837. Update indexes.84 - Update `.wingman/project-map/index.md`.85 - Update the relevant section `index.md`.86 - Update `glossary/index.md` only when there is a useful user-language to code-language mapping.87 - Update `relationships/index.md` only when it already exists or when a clear cross-entry relationship is important. First version may rely on each entry's `Related Entries`.8889## References9091- Read `references/kind-selection.md` only when kind choice is ambiguous.92- Read `references/entry-templates.md` before creating or substantially changing an entry.93- Do not read all references by default if updating only an index row or correcting a small typo.9495## Ask The User When9697- The target capability cannot be identified from paths, active context, source search, docs, or user wording.98- Two possible kinds would produce materially different entries and evidence does not settle the choice.99- Writing the entry would require treating an inferred business meaning as confirmed fact.100101## Safety Rules102103- Do not create or update multiple unrelated entries in one invocation.104- Do not write "possible" or "likely" as fact.105- Do not bulk-generate low-signal entries to cover a whole repository.106- Do not overwrite user-authored `Notes For Agents`, `Use When`, `Do Not Use When`, or status unless evidence or explicit user instruction proves they are outdated.107- If project memory current truth conflicts with a project-map entry, keep memory truth authoritative and mark the map entry as needing update.108- Do not migrate `.wingman/registry/` automatically. Treat old registry files as non-authoritative historical hints unless the user asks for migration.109110## Final Response111112Report concisely:113114- entry name and kind115- entry path116- status and evidence level117- updated indexes118- key tags or search hints119- any unverified gaps120121## Checklist122123Before finishing, verify:124125- [ ] I processed one coherent capability.126- [ ] I read evidence before writing facts.127- [ ] I checked existing project-map entries for duplicates.128- [ ] I created or updated exactly one main entry.129- [ ] I updated the top-level index and relevant section index.130- [ ] I clearly labeled unknown, inferred, or stale information.