@aabadin/project-memory-context 0.1.4 → 0.2.0

package/templates/opencode/commands/enrich-status.md

@@ -0,0 +1,21 @@
+---
+name: enrich-status
+description: Show enrichment progress — pending, enriched, stale, and failed symbols in the worklist.
+argument-hint: ""
+allowed-tools:
+  - Bash
+---
+
+<objective>
+Display the current enrichment queue status: how many symbols have been enriched, how many are pending, stale, or failed.
+</objective>
+
+<execution>
+Run:
+
+```bash
+{{PMC_BIN}} status .
+```
+
+This shows the worklist summary with counts for pending, enriched, stale, and failed symbols.
+</execution>

package/templates/opencode/commands/get-context.md

@@ -1,22 +1,39 @@
 ---
 name: get-context
-description: Retrieve structured project context from agent-memory for the current project.
-argument-hint: "<target>"
+description: Retrieve structured project context for a target (symbol, file, or query).
+argument-hint: "<target> [depth] [focus]"
 allowed-tools:
   - Bash
   - Read
 ---
 
 <objective>
-Retrieve and display structured project context from agent-memory. Use before reading files to get a structural overview.
+Retrieve and display structured project context for the given target. Use before reading files to get a structural overview.
 </objective>
 
 <execution>
-Run:
+Auto mode (recommended):
+
+```bash
+{{PMC_BIN}} context <target> [depth] [focus]
+```
+
+Explicit modes:
+
+```bash
+{{PMC_BIN}} context symbol <target> [depth] [focus]
+{{PMC_BIN}} context file <target> [depth] [focus]
+{{PMC_BIN}} context query <target> [depth] [focus]
+```
+
+Depths: compact (default), extended, deep.
+Focus modes: all (default), dependencies, callers, containment, impact.
+
+Repository refresh (legacy):
 
 ```bash
 {{PMC_BIN}} context . --refresh
 ```
 
-This materializes or refreshes the 9 base project-context memories and outputs a summary.
+This resets the 9 base project-context memories without a specific target.
 </execution>

package/templates/opencode/commands/init-project.md

@@ -0,0 +1,21 @@
+---
+name: init-project
+description: Initialize PMC project structure — creates .planning/project-memory-context/ directory tree.
+argument-hint: ""
+allowed-tools:
+  - Bash
+---
+
+<objective>
+Initialize the PMC directory structure in the current project. Creates the .planning/project-memory-context/ hierarchy and default configuration.
+</objective>
+
+<execution>
+Run:
+
+```bash
+{{PMC_BIN}} init .
+```
+
+This creates the full directory tree under `.planning/project-memory-context/` with intake, graph, enrichment, project-context, and runs subdirectories.
+</execution>

package/templates/opencode/commands/{new-project.md → map-project.md}

@@ -1,5 +1,5 @@
 ---
-name: new-project
+name: map-project
 description: Bootstrap PMC in the current project with graphify, worklist, and base memories.
 argument-hint: "[--all] [--enrich]"
 allowed-tools:

package/templates/pmc-skill/SKILL.md

@@ -0,0 +1,34 @@
+# PMC-Aware Workflow
+
+PMC first, files second.
+
+Before reading more than 3 files, query PMC for structural context first. Use PMC to understand symbols, dependencies, and callers before falling back to raw file reads.
+
+## Rule of thumb
+
+- Query PMC before reading more than 3 files.
+- Prefer PMC summaries for architecture, dependencies, and symbol lookup.
+- Read source files after PMC when you need exact implementation details.
+
+## Available commands
+
+- `/map-project`
+- `/get-context`
+- `/enrich-status`
+- `/doctor`
+- `/init-project`
+- `/sync-context`
+- `/sanitize`
+
+- `/get-context <target> [depth] [focus]`—resolve a symbol, file, or query and return structural context
+
+## Available MCP tools
+
+- `pmc_query_project`
+- `pmc_search_symbols`
+- `pmc_get_dependents`
+- `pmc_get_dependencies`
+
+## Why this saves tokens
+
+PMC returns focused structural context, so the agent can avoid loading many full files into context. Querying graph-backed summaries first usually costs fewer tokens than broad file reads and helps reserve file inspection for the exact places that matter.