Files

T

Developer 3e7410b6bd chore: track .pi-map.md and .pi-map.index.md artifacts

Remove the map files from .gitignore so they are committed as project
navigation artifacts, and also unignore them in the sample fixture.
Regenerate all maps so the committed versions reflect the current source.

2026-06-16 14:38:42 +00:00

1.8 KiB

Raw Permalink Blame History

. (index)

dir: .

Project Map Protocol

Read this protocol and the root .pi-map.index.md first.
Use index: / map: references to open relevant directory indexes and maps.
Load indexes before rich maps during task-start navigation.
Read the local rich map and actual source before editing.
Treat non-empty ## dirty sections in either artifact as stale.
If source and generated artifacts disagree, trust source.
If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
After editing source, run project_map_patch for each changed file.
Before broad architectural claims or final handoff, run project_map_validate when freshness matters.

Trust boundary: index routes, map orients, source decides.

role

A TypeScript/Node.js CLI tool and Pi extension that generates paired markdown analysis artifacts (.pi-map.index.md and .pi-map.md) to provide hierarchical codebase navigation and contextual orientation for AI coding agents.

parent

children

.atl index: .atl/.pi-map.index.md map: .atl/.pi-map.md
fixtures index: fixtures/.pi-map.index.md map: fixtures/.pi-map.md
openspec index: openspec/.pi-map.index.md map: openspec/.pi-map.md
src index: src/.pi-map.index.md map: src/.pi-map.md
tests index: tests/.pi-map.index.md map: tests/.pi-map.md

files

.gitignore
.npmrc
README.md
SKILL.md
design-doc.md
package-lock.json
package.json
pi-extension.ts
troubleshooting.md
tsconfig.json
usage-guide.md

links

index: ./.pi-map.index.md map: ./.pi-map.md

workflows

change project behavior read: .gitignore, .npmrc, pi-extension.ts
change project config read: package-lock.json, package.json, tsconfig.json
explore project subdirectories index: .atl/.pi-map.index.md, fixtures/.pi-map.index.md, openspec/.pi-map.index.md

1.8 KiB Raw Permalink Blame History