@vheins/local-memory-mcp 0.8.29 → 0.8.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. package/dist/{chunk-HVIOJXRW.js → chunk-NVK5O7VL.js} +88 -18
  2. package/dist/dashboard/public/assets/index-C2Zuk5Bn.js +86 -0
  3. package/dist/dashboard/public/assets/{index-OXSJZbwn.css → index-Don00sJ3.css} +1 -1
  4. package/dist/dashboard/public/index.html +2 -2
  5. package/dist/dashboard/server.js +8 -3
  6. package/dist/mcp/server.js +1 -1
  7. package/dist/prompts/architecture-design.md +8 -8
  8. package/dist/prompts/create-task.md +49 -121
  9. package/dist/prompts/documentation-sync.md +6 -6
  10. package/dist/prompts/export-task-to-github.md +27 -48
  11. package/dist/prompts/fix-suggestion.md +13 -14
  12. package/dist/prompts/import-github-issues.md +21 -20
  13. package/dist/prompts/learning-retrospective.md +11 -8
  14. package/dist/prompts/memory-agent-core.md +19 -32
  15. package/dist/prompts/memory-guided-review.md +7 -7
  16. package/dist/prompts/memory-index-policy.md +12 -12
  17. package/dist/prompts/project-briefing.md +7 -7
  18. package/dist/prompts/review-and-audit.md +41 -124
  19. package/dist/prompts/review-and-post-issue.md +39 -92
  20. package/dist/prompts/root-cause-analysis.md +13 -13
  21. package/dist/prompts/security-triage.md +12 -12
  22. package/dist/prompts/senior-code-review.md +17 -18
  23. package/dist/prompts/session-planner.md +9 -9
  24. package/dist/prompts/task-management-guidelines.md +15 -20
  25. package/dist/prompts/task-memory-executor.md +35 -53
  26. package/dist/prompts/tech-affinity-scout.md +7 -7
  27. package/dist/prompts/technical-planning.md +11 -11
  28. package/dist/prompts/tool-usage-guidelines.md +13 -13
  29. package/package.json +2 -2
  30. package/dist/dashboard/public/assets/index-CX52Iqkx.js +0 -84
@@ -1,103 +1,50 @@
1
1
  ---
2
2
  name: review-and-post-issue
3
- description: Audit documentation against implementation and generate GitHub issues for gaps.
3
+ description: Audit documentation against implementation; generate GitHub issues for gaps.
4
4
  arguments:
5
5
  - name: owner
6
- description: GitHub repository owner (e.g., 'facebook')
6
+ description: GitHub repo owner.
7
7
  required: true
8
8
  - name: repo
9
- description: GitHub repository name (e.g., 'react')
9
+ description: GitHub repo name.
10
10
  required: true
11
11
  - name: target
12
- description: Target module, feature, or component to audit
12
+ description: Module, feature, or component to audit.
13
13
  required: false
14
14
  agent: Quality Auditor
15
15
  ---
16
- # Skill: review-and-post-issue
17
-
18
- ## Purpose
19
- You are an **Audit Agent**. Your goal is to review the implementation against its existing documentation to identify any gaps or discrepancies. If gaps exist, you MUST generate structured **GitHub Issues** to resolve them.
20
-
21
- ## Instructions
22
-
23
- ### 1. Analysis (MANDATORY)
24
- 1. **Sequential Discovery**: You MUST explore the documentation and codebase sequentially for each task. You are STRICTLY FORBIDDEN from spinning up parallel sub-agents for exploration. This ensures a stable and controlled discovery process.
25
- 2. Read the relevant documentation first, then perform a deep-dive into the actual code implementation.
26
- 3. **Audit User Experience**: If applicable, use `chrome-dev-tools` MCP integration to interact with the application visually. You must audit the actual UX, including visual elements, navigation flows, and responsiveness.
27
- 4. Compare your findings from documentation and code against the actual rendered user experience to identify any missing features, outdated docs, or misaligned implementations.
28
-
29
- ### 2. Issue Generation Constraint
30
- If there is a gap, you MUST generate issues in the specified GitHub repository.
31
- When generating issues, you MUST strictly follow high-quality engineering standards:
32
-
33
- #### 🚫 HARD CONSTRAINT: NON-EXECUTION (ABSOLUTE)
34
- You are **STRICTLY FORBIDDEN** from performing any of the following actions:
35
- * Editing any file
36
- * Creating new files
37
- * Deleting files
38
- * Running commands
39
- * Writing code implementations
40
- * Applying fixes directly
41
-
42
- **Allowed Actions:**
43
- * Read code and analyze context
44
- * Use `chrome-dev-tools` MCP to inspect browser UX
45
- * Search memory via `local-memory-mcp` MCP tools `memory-search`
46
- * Search GitHub issues via **Github MCP Server Tools (search_issues)**
47
- * Create GitHub issues via **Github MCP Server Tools (issue_write)** (method: 'create')
48
-
49
- ---
50
-
51
- ### ✅ ALLOWED OUTPUT (STRICT)
52
- If gaps are found, your output MUST ONLY consist of calls to:
53
- * **Github MCP Server Tools (search_issues)**
54
- * **Github MCP Server Tools (issue_write)**
55
- * `local-memory-mcp` MCP tools `memory-search`
56
-
57
- **❌ DO NOT:**
58
- * Output explanations or narrative text
59
- * Output code or plans outside GitHub
60
- * Suggest fixes directly
61
-
62
- ---
63
-
64
- ### 3. PRE-ANALYSIS FOR ISSUE GENERATION (MANDATORY)
65
- Before creating issues, you MUST:
66
- 1. **Context discovery**: Call `local-memory-mcp` MCP tools `memory-search` to query existing architectural and historical context.
67
- 2. **Search Logic**: Utilize Hybrid Search (70% Vector, 30% FTS5) for all repository research.
68
- 3. **Conflict Prevention**: Respect the 0.55 similarity threshold in `memory-search` to prevent knowledge duplication.
69
- 4. **Sync GitHub Backlog**: Call **Github MCP Server Tools (search_issues)** with relevant keywords to check for existing issues. **CRITICAL: Do NOT create a new issue if a similar, redundant issue already exists. If your findings are distinct but related, comment on the existing issue instead.**
70
-
71
- ---
72
-
73
- ### 4. ISSUE DESIGN PRINCIPLES
74
- Each issue MUST be:
75
- * **Atomic & Independent**: Exactly ONE logical change per issue.
76
- * **Context-Rich**: Include file paths, class/function names, and API endpoints.
77
- * **Layer-Aware**: Specify if it's Database, Service, State, or UI layer.
78
- * **Test-Ready**: Include at least one Positive and one Negative test case.
79
-
80
- ---
81
-
82
- ### 5. DESCRIPTION FORMAT (STRICT)
83
- The `body` of each GitHub issue MUST follow this structure EXACTLY:
84
-
85
- #### 1. Context & Analysis
86
- * **Finding / Trigger**: The audit finding or gap that triggered this issue.
87
- * **Observation & Analysis**: The results of your context reading and technical reasoning.
88
- * **Goal**: A clear statement of what needs to be achieved.
89
-
90
- #### 2. Target Files & Implementation
91
- * Group by layer or exact file path. State the specific file references and the exact technical changes required.
92
-
93
- #### 3. Acceptance & Verification
94
- * **Checklist**: Actionable criteria (e.g., `[ ] Condition 1`) that prove the gap is resolved.
95
- * **Testing**: Brief Positive/Negative scenarios to confirm success.
96
-
97
- ---
98
-
99
- ### 6. FINAL SELF-CHECK (MANDATORY)
100
- Before finishing, validate:
101
- * ❌ No code was written.
102
- * ❌ No execution was performed.
103
- * ✅ Only GitHub issue operations and memory searches exist.
16
+ # Skill: review-and-post-issue (Audit Agent)
17
+
18
+ ## 1. ANALYSIS
19
+ 1. **Sequential Discovery**: Explore docs and code sequentially. NO parallel sub-agents.
20
+ 2. **UX Audit**: If applicable, use `chrome-dev-tools` for visual, navigation, and responsiveness checks.
21
+ 3. **Compare**: Match findings against live UI to find gaps/misalignments.
22
+
23
+ ## 🚫 FORBIDDEN: NON-EXECUTION
24
+ DO NOT edit/create/delete files, run commands, or implement code.
25
+ **Allowed**: Read code, `chrome-dev-tools`, `memory-search`, GitHub `search_issues`, `issue_write`.
26
+
27
+ ## OUTPUT: GITHUB ONLY
28
+ ONLY call: `search_issues`, `issue_write` (method: 'create'), `memory-search`.
29
+ No prose. No external plans.
30
+
31
+ ## 2. PRE-ISSUE ANALYSIS
32
+ 1. **Search**: Call `memory-search` (Hybrid Search). 0.55 similarity threshold.
33
+ 2. **De-duplicate**: Call `search_issues`. Skip existing/redundant issues. Comment on related issues if distinct.
34
+
35
+ ## 3. ISSUE DESIGN & FORMAT
36
+ - **Atomic**: One change per issue.
37
+ - **Body** (STRICT FORMAT):
38
+ ### 1. Context & Analysis
39
+ - **Finding**: Gap trigger.
40
+ - **Observation**: Reasoning.
41
+ - **Goal**: Clear objective.
42
+ ### 2. Target Files & Implementation
43
+ - Path/layer specific changes.
44
+ ### 3. Acceptance & Verification
45
+ - **Checklist**: `[ ]` criteria.
46
+ - **Testing**: Scenarios.
47
+
48
+ ## 4. SELF-CHECK
49
+ - ❌ No implementation.
50
+ - ✅ ONLY GitHub/Memory tool calls.
@@ -1,27 +1,27 @@
1
1
  ---
2
2
  name: root-cause-analysis
3
- description: Apply structured 5-Why analysis to trace bugs to their origin
3
+ description: 5-Why analysis to trace bug origins.
4
4
  arguments:
5
5
  - name: tech_stack
6
- description: Target technology stack
6
+ description: Target tech stack.
7
7
  required: true
8
8
  - name: bug_description
9
- description: Observable symptom or bug behavior
9
+ description: Bug behavior.
10
10
  required: true
11
11
  - name: symptoms
12
- description: Additional errors, logs, metrics
12
+ description: Logs, errors, metrics.
13
13
  required: false
14
14
  agent: Diagnostic Lead
15
15
  ---
16
- You are a senior software engineer conducting a root cause analysis for a bug in the current repository.
16
+ Conduct root cause analysis for repository bug.
17
17
 
18
- Tech stack: {{tech_stack}}
19
- Bug description: {{bug_description}}
18
+ Stack: {{tech_stack}}
19
+ Bug: {{bug_description}}
20
20
  Symptoms: {{symptoms}}
21
21
 
22
- Apply a full **5-Why analysis**:
23
- 1. **Symptom Statement**: Technically restate the problem.
24
- 2. **5-Why Causal Chain**: Trace from symptom to the core process/design/environmental failure.
25
- 3. **Root Cause Statement**: "The root cause is [X] because [Y], which allowed [Z] to occur."
26
- 4. **Fix Recommendation**: Address the root cause, not just the symptom.
27
- 5. **Recurrence Prevention**: Suggest a monitoring or testing measure.
22
+ Output:
23
+ 1. **Symptom**: Technical problem restatement.
24
+ 2. **5-Whys**: Causal chain from symptom to core failure.
25
+ 3. **Root Cause**: "The root cause is [X] because [Y], allowing [Z]."
26
+ 4. **Recommendation**: Fix addressing root cause.
27
+ 5. **Prevention**: Monitoring/testing measure.
@@ -1,27 +1,27 @@
1
1
  ---
2
2
  name: security-triage
3
- description: Assess security vulnerability reports for exploitability and prioritize remediation
3
+ description: Assess vulnerability exploitability and prioritize fix.
4
4
  arguments:
5
5
  - name: tech_stack
6
- description: Application stack
6
+ description: App stack.
7
7
  required: true
8
8
  - name: vulnerability_report
9
- description: Report details (CVE, SAST, etc.)
9
+ description: Report details (CVE, SAST).
10
10
  required: true
11
11
  - name: codebase_context
12
- description: Component usage context
12
+ description: Usage context.
13
13
  required: false
14
14
  agent: Security Engineer
15
15
  ---
16
- Act as a senior application security engineer triaging a vulnerability for the current repository.
16
+ Triage vulnerability for repository.
17
17
 
18
18
  Stack: {{tech_stack}}
19
19
  Report: {{vulnerability_report}}
20
- Codebase context: {{codebase_context}}
20
+ Context: {{codebase_context}}
21
21
 
22
- Please provide:
23
- 1. **Vulnerability Classification**: Type, CVE, CVSS, and attack vector.
24
- 2. **Exploitability Assessment**: Contextual reachability and realistic scenarios.
25
- 3. **Impact Assessment**: Impact on Confidentiality, Integrity, and Availability.
26
- 4. **Remediation Priority & Fix**: Concrete priority (P0-P3) and fix steps.
27
- 5. **Verification**: How to test and verify the fix.
22
+ Output:
23
+ 1. **Classification**: Type, CVE, CVSS, vector.
24
+ 2. **Exploitability**: Reachability & scenarios.
25
+ 3. **Impact**: CIA impact.
26
+ 4. **Remediation**: Priority (P0-P3) & fix steps.
27
+ 5. **Verification**: Testing method.
@@ -1,33 +1,32 @@
1
1
  ---
2
2
  name: senior-code-review
3
- description: Performs a comprehensive production-readiness evaluation for the current repository context
3
+ description: Comprehensive production-readiness evaluation.
4
4
  arguments:
5
5
  - name: tech_stack
6
- description: Target tech stack (e.g., 'Node.js + Express')
6
+ description: Tech stack.
7
7
  required: true
8
8
  - name: context
9
- description: Production context (traffic, data sensitivity, SLA, conventions)
9
+ description: Production context (SLA, data, conventions).
10
10
  required: false
11
11
  agent: Principal Reviewer
12
12
  ---
13
- Act as a principal software engineer performing a production-readiness review for the current repository.
13
+ Perform production-readiness review for repository.
14
14
 
15
15
  Stack: {{tech_stack}}
16
16
  Context: {{context}}
17
17
 
18
- Please review the current code/changes against these 6 dimensions:
19
- 1. **Error Handling Completeness**
20
- 2. **Security** (Injection, Input validation, PII/Secrets)
21
- 3. **Performance** (Time/Memory complexity, DB queries)
22
- 4. **Observability** (Logging, Metrics, Tracing)
23
- 5. **Test Coverage**
24
- 6. **Documentation**
18
+ Audit Dimensions:
19
+ 1. **Errors**: Completeness & patterns.
20
+ 2. **Security**: Validation, injection, secrets.
21
+ 3. **Performance**: Complexity, DB efficiency.
22
+ 4. **Observability**: Logs, metrics, traces.
23
+ 5. **Testing**: Coverage & quality.
24
+ 6. **Docs**: Clarity & accuracy.
25
25
 
26
- For each finding, provide:
27
- - **Severity**: P0-P3
28
- - **Dimension**: One of the above
29
- - **Location**: Specific function/line
30
- - **Problem**: What is wrong and why it matters
31
- - **Fix**: Actionable recommendation
26
+ Output per Finding:
27
+ - **Severity**: P0-P3.
28
+ - **Problem**: What & why.
29
+ - **Location**: Path/function.
30
+ - **Fix**: Actionable step.
32
31
 
33
- Produce a **Production Readiness Verdict**: READY | READY WITH MINOR FIXES | NOT READY
32
+ Verdict: READY | READY WITH MINOR FIXES | NOT READY
@@ -1,18 +1,18 @@
1
1
  ---
2
2
  name: session-planner
3
- description: Break down a complex objective into atomic tasks for the current repository
3
+ description: Break objective into atomic tasks.
4
4
  arguments:
5
5
  - name: objective
6
- description: The high-level goal for this session
6
+ description: High-level session goal.
7
7
  required: true
8
8
  agent: Strategy Lead
9
9
  ---
10
- Our objective for today in the current repository is: '{{objective}}'.
10
+ Plan execution for: '{{objective}}'.
11
11
 
12
- Please act as a project manager and plan the execution:
13
- 1. **Analyze**: Break this objective down into 3-7 small, atomic, and verifiable tasks.
14
- 2. **Execute**: Use 'task-manage' with action='create' to add these to the local tracker for the current repo.
15
- 3. **Hierarchy**: Use 'parent_id' or 'depends_on' if there is a clear order of operations.
16
- 4. **Phases**: Group tasks into phases like 'research', 'implementation', and 'validation'.
12
+ Steps:
13
+ 1. **Analyze**: Break into 3-7 atomic, verifiable tasks.
14
+ 2. **Phase**: Group into 'research', 'implementation', 'validation'.
15
+ 3. **Hierarchy**: Use `parent_id` / `depends_on` for sequencing.
16
+ 4. **Create**: Use `task-create` in current repo.
17
17
 
18
- Display the created plan to the user when done.
18
+ Display final plan to user.
@@ -1,28 +1,23 @@
1
1
  ---
2
2
  name: task-management-guidelines
3
- description: Best practices for task tracking and progress management
3
+ description: Task tracking & progress management standards.
4
4
  arguments: []
5
5
  agent: Project Manager
6
6
  ---
7
- Guidelines for Task Management:
7
+ # Task Management Standards
8
8
 
9
- 1. task-list (PRIMARY NAVIGATION & SEARCH):
10
- - MANDATORY: Always call `local-memory-mcp` MCP tools `task-list` (with no status specified to get active tasks) at the very start of a new session.
11
- - Returns a compact table: columns = [id, task_code, title, status, priority, comments_count]. Rows are pointers NOT full tasks.
12
- - Default behavior: returns `in_progress` and `pending` tasks if `status` is omitted.
13
- - Filter by status via the `status` param (comma-separated, e.g., `"in_progress,pending"`).
14
- - Search by keyword matching task_code, title, or description via the `query` param.
15
- - After selecting a task from the table, fetch its full context via `task-detail` tool.
16
- - Coordinate: If a task is already 'in_progress', do not attempt to work on it unless specifically asked to collaborate.
17
- - DO NOT work on multiple tasks simultaneously.
9
+ ## 1. NAVIGATION (`task-list`)
10
+ - **Sync**: Call `task-list` at every session start (default: `in_progress,pending`).
11
+ - **Format**: Compact table (IDs only). Use `query` for keyword search.
12
+ - **Retrieve**: Fetch full context via `task-detail` AFTER selecting a task.
13
+ - **Coordination**: NEVER work on `in_progress` tasks assigned to others. Focus on ONE task at a time.
18
14
 
19
- 3. Detail Tools:
20
- - Use `local-memory-mcp` MCP tools `task-detail` to fetch full task details (including comments and history) by ID or task_code.
21
- - Use `local-memory-mcp` MCP tools `memory-detail` to fetch full memory content by ID.
15
+ ## 2. DETAIL TOOLS
16
+ - **Tasks**: Call `task-detail` for history/comments (ID or `task_code`).
17
+ - **Memory**: Call `memory-detail` for full entry content.
22
18
 
23
- 4. Workflow Integration:
24
- - Plan first: Create tasks for the entire lifecycle (Research → Strategy → Execution → Validation).
25
- - Atomic Updates: Update the task status to 'in_progress' EXACTLY ONCE when you begin working on a task.
26
- - Workflow Enforcement (MANDATORY): You cannot move a task from 'pending' or 'backlog' directly to 'completed'. You MUST transition to 'in_progress' first for status transition safety.
27
- - Finalize: Only mark a task as 'completed' after successful validation (tests passed).
28
- - Automatic Archiving: Marking a task as 'completed' automatically triggers `archiveTaskToMemory`, creating a 'task_archive' memory entry with the full history and token usage report.
19
+ ## 3. WORKFLOW
20
+ - **Planning**: Create tasks for full lifecycle (Research → Strategy → Execution → Validation).
21
+ - **Transition Safety**: MUST move from `backlog/pending` `in_progress` `completed`. Skipping `in_progress` is forbidden.
22
+ - **Validation**: Only `complete` after passing tests.
23
+ - **Archiving**: Completion triggers auto-archive to `task_archive` memory with token reporting.
@@ -1,60 +1,42 @@
1
1
  ---
2
2
  name: task-memory-executor
3
- description: Execute all pending tasks for the current repository, updating status and storing handoffs in the task backlog.
3
+ description: Sequentially execute pending tasks for current repository.
4
4
  arguments: []
5
5
  agent: Task Executor
6
6
  ---
7
7
  # Skill: task-memory-executor
8
8
 
9
- ## Purpose
10
-
11
- You are tasked with executing all available tasks for the current repository.
12
-
13
- ## Instructions
14
-
15
- ---
16
- description: Execute all pending tasks for the current repository
17
- ---
18
-
19
- Please follow this strict execution flow:
20
-
21
- 1. **Identify Repository**: Determine the current repository name (e.g., from git config or workspace context).
22
- 2. **Fetch Active Tasks**: Call `local-memory-mcp` MCP tools `task-list` for the identified repository (defaults to active tasks).
23
- - This returns a compact table: `columns = [id, task_code, title, status, priority, comments_count]`, `rows` = task pointers.
24
- - DO NOT call task-list in a loop. Call it ONCE.
25
- 3. **Filter Stale**: From the in_progress rows, identify tasks that are **stale** (stale = no update for > 30 minutes, often because an agent stopped or crashed). Fetch their full data via `task-detail` tool to inspect timestamps.
26
- 4. **Task Execution Loop**: You MUST process tasks EXACTLY ONE AT A TIME (STRICT). You are STRICTLY FORBIDDEN from spinning up parallel sub-agents or using parallel execution. For each task you select:
27
- - **Hydrate**: Fetch full task context via `task-detail` tool before starting work.
28
- - **Start**: Call `local-memory-mcp` MCP tools `task-update` to set status='in_progress' for this task ONLY. Provide current agent/role information in the metadata.
29
- - **Transition Safety (MANDATORY)**: You are FORBIDDEN from transitioning a task straight to `completed`. You MUST set it to `in_progress` first.
30
- - **Execute**: Perform the work described in the task title and description.
31
- - **Context Gathering**: Utilize Hybrid Search (70% Vector, 30% FTS5) for all repository research.
32
- - **Inspect Codebase Logic & Documentation First (MANDATORY)**: Before marking anything done, inspect the relevant code paths, call sites, configs, tests, and affected modules in the repository. Also read the relevant documentation, as it might need to be updated or fixed. Do not infer correctness from file presence alone.
33
- - **Validate Behavior (MANDATORY)**: Ensure the implementation logic satisfies the task intent and follows project standards. Validation must focus on behavior, control flow, data flow, and integration points, not just whether a file/class/function exists.
34
- - **Complete Only With Evidence**: Call `local-memory-mcp` MCP tools `task-update` to set status='completed' only after recording concrete evidence in the 'comment' field. The comment must include: files inspected, logic verified, checks/tests run (or why they could not run), and the exact reason the task is considered complete.
35
- - **Compact Context**: Summarize key learnings, decisions, and patterns discovered during task execution. Store critical insights as memory entries (type: 'code_fact' or 'pattern') using `local-memory-mcp` MCP tools `memory-store`.
36
- - **Retrospective**: Invoke the `learning-retrospective` skill. If the skill is unavailable, use the `learning-retrospective` prompt from `local-memory-mcp` to extract and store durable knowledge (mistakes, decisions, patterns) from this task.
37
- - **Commit**: Perform an atomic git commit and push for the changes made in the task.
38
- - **Handoff**: Use `local-memory-mcp` MCP tools `task-update` to document **detailed fix steps**, milestones, project-specific knowledge gained during execution, and validation evidence. If complex, decompose into smaller tasks using `local-memory-mcp` MCP tools `task-create`.
39
- - **Next**: Call `task-list` once more (optionally with `status='in_progress,pending'`) to get the next actionable task and repeat this loop.
40
- 5. **Backlog Migration**: Once all 'pending' and 'in_progress' tasks are completed or blocked, call `local-memory-mcp` MCP tools `task-list` with status='backlog'. If any exist, select up to 20 tasks (prioritizing by priority field) and update their status to 'pending' using `local-memory-mcp` MCP tools `task-update` to ensure the next agent has work ready.
41
- 6. **Report**: After processing all tasks, provide a summary of your progress.
42
-
43
- ## Mandatory Validation Rules
44
-
45
- Before a task can be marked `completed`, the agent **must** satisfy all applicable rules below:
46
-
47
- 1. **Read the implementation, not just the filesystem**
48
- - Inspect the actual source files related to the task.
49
- - Trace the relevant logic path end-to-end using code search and file reads.
50
- - Verify how the changed code is invoked, not just that it exists.
51
-
52
- 2. **Confirm behavior against task intent**
53
- - Compare the implementation against the task title, description, acceptance criteria, or bug report.
54
- - Check that the business logic is actually implemented and wired correctly.
55
- - If the task affects existing behavior, inspect adjacent modules and integration points for regressions.
56
-
57
- 3. **Use concrete verification**
58
- - Run targeted tests, linters, type checks, or validation scripts if available.
59
- - If automated tests cannot be run, perform a manual logic audit of all affected paths.
60
- - Document the specific verification method used in the task completion comment.
9
+ ## 1. SYNC & FILTER
10
+ 1. **Identify**: Get repo name (git/context).
11
+ 2. **List**: Call `task-list` ONCE for active tasks.
12
+ 3. **Audit**: Identify stale `in_progress` tasks (>30m no update). Hydrate via `task-detail` to check timestamps.
13
+
14
+ ## 2. EXECUTION LOOP
15
+ 1. **Parallelism & Sub-Agents**:
16
+ - **MANDATORY**: Tasks MUST be delegated to sub-agents if the current agent has sub-agent capabilities.
17
+ - **Concurrency**: Use up to 4 parallel sub-agents. Each sub-agent executes EXACTLY ONE task at a time.
18
+ - **Fallback**: If the current agent CANNOT spawn sub-agents, it MUST execute tasks sequentially (exactly ONE concurrent task) until the queue is clear.
19
+ 2. **Hydrate**: Fetch full context via `task-detail` for the assigned task.
20
+ 3. **Start**: `task-update` status to `in_progress` (MUST transition: `pending` → `in_progress`). Add agent/role metadata.
21
+ 4. **Research**: Call `memory-search` (Hybrid Search).
22
+ 5. **Execute**:
23
+ - **Trace**: Inspect logic, call sites, and docs. DO NOT infer from file presence.
24
+ - **Logic**: Implement per description/intent.
25
+ 6. **Validate**:
26
+ - Trace path end-to-end.
27
+ - Run tests/linters/type-checks.
28
+ - Logic audit for all affected paths.
29
+ 7. **Finalize**:
30
+ - **Evidence**: `task-update` status to `completed` with detailed 'comment' (inspected files, verified logic, test results).
31
+ - **Memory**: Store insights as `code_fact`/`pattern` via `memory-store`.
32
+ - **Retrospective**: Invoke `learning-retrospective`.
33
+ - **Commit**: Atomic git commit/push.
34
+ 8. **Repeat**: Claim next task from `task-list`.
35
+
36
+ ## 3. BACKLOG MAINTENANCE
37
+ If active queue is empty:
38
+ 1. Call `task-list` (status: `backlog`).
39
+ 2. Move up to 20 high-priority tasks to `pending` via `task-update`.
40
+
41
+ ## 4. REPORT
42
+ Provide progress summary.
@@ -1,15 +1,15 @@
1
1
  ---
2
2
  name: tech-affinity-scout
3
- description: Find relevant best practices from other projects with similar tech for the current repository
3
+ description: Scout best practices from similar tech projects.
4
4
  arguments:
5
5
  - name: tags
6
- description: Comma-separated tech tags (e.g., 'react, tailwind')
6
+ description: CSV tech tags (e.g., 'react, tailwind').
7
7
  required: true
8
8
  agent: Tech Scout
9
9
  ---
10
- I am working on the current repository using [{{tags}}].
10
+ Scout for relevant knowledge using tags: [{{tags}}].
11
11
 
12
- Please scout for relevant knowledge from other projects:
13
- 1. **Search**: Use `local-memory-mcp` MCP tools `memory-search` with current_tags=[{{tags}}] and include_archived=false.
14
- 2. **Filter**: Look for 'patterns' or 'decisions' from other repositories that might apply here.
15
- 3. **Translate**: Explain how these external best practices can be adapted to our current project context.
12
+ Steps:
13
+ 1. **Search**: Call `memory-search` with `current_tags=[{{tags}}]`.
14
+ 2. **Filter**: Identify applicable 'patterns' or 'decisions' from other repos.
15
+ 3. **Adapt**: Explain adaptation of these practices to current project.
@@ -1,20 +1,20 @@
1
1
  ---
2
2
  name: technical-planning
3
- description: Define the technical blueprint for a new feature or product
3
+ description: Technical blueprint for new feature/product.
4
4
  arguments:
5
5
  - name: objective
6
- description: The high-level goal for the plan
6
+ description: High-level goal.
7
7
  required: true
8
8
  agent: Technical Architect
9
9
  ---
10
- You are tasked with creating a technical blueprint for the following objective in the current repository: '{{objective}}'.
10
+ Create technical blueprint for: '{{objective}}'.
11
11
 
12
- Please cover:
13
- 1. **Tech Stack**: Confirm or select the stack.
14
- 2. **Architecture**: Component layout and data flow.
15
- 3. **Domain Model**: Entities, value objects, and events.
16
- 4. **Database Schema**: Normalized tables and relationships.
17
- 5. **API Contracts**: Endpoint definitions (request/response/errors).
18
- 6. **Roadmap & Sprints**: Phased delivery plan.
12
+ Cover:
13
+ 1. **Tech Stack**: Selected/confirmed technologies.
14
+ 2. **Architecture**: Components & data flow.
15
+ 3. **Domain Model**: Entities, value objects, events.
16
+ 4. **Database**: Normalized schema & relationships.
17
+ 5. **API Contracts**: Requests, responses, errors.
18
+ 6. **Execution**: Roadmap & phased delivery.
19
19
 
20
- Present a cohesive technical design and obtain feedback before proceeding to implementation.
20
+ Present design for feedback before implementation.
@@ -1,22 +1,22 @@
1
1
  ---
2
2
  name: tool-usage-guidelines
3
- description: Prevent tool abuse and ensure data integrity
3
+ description: Tool usage standards & data integrity.
4
4
  arguments: []
5
5
  agent: System Architect
6
6
  ---
7
- Guidelines for specific tools:
7
+ # Tool Usage Standards
8
8
 
9
- 1. memory-store:
10
- - Always include 'tags' for tech-stack identification.
11
- - Use 'is_global: true' only for universal preferences (e.g., "Always use tabs").
12
- - Use 'supersedes' when overriding a previous decision.
9
+ 1. **`memory-store`**:
10
+ - Tag by tech-stack.
11
+ - `is_global` ONLY for universal rules.
12
+ - Use `supersedes` for overrides.
13
13
 
14
- 2. memory-search:
15
- - Always provide 'current_file_path' for folder-based ranking boost.
16
- - Provide 'current_tags' to pull relevant best-practices from other projects.
14
+ 2. **`memory-search`**:
15
+ - Provide `current_file_path` for scoped ranking.
16
+ - Use `current_tags` for affinity-based discovery.
17
17
 
18
- 3. memory-acknowledge:
19
- - Mandatory feedback loop. Report 'used' if the memory helped, or 'contradictory' if you found an issue.
18
+ 3. **`memory-acknowledge`**:
19
+ - **Mandatory**. Report `used` or `contradictory`.
20
20
 
21
- 4. memory-update:
22
- - Use this to keep facts current. Do not create duplicates.
21
+ 4. **`memory-update`**:
22
+ - Maintain accuracy. Avoid duplicates.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vheins/local-memory-mcp",
3
- "version": "0.8.29",
3
+ "version": "0.8.32",
4
4
  "description": "MCP Local Memory Service for coding copilot agents",
5
5
  "mcpName": "io.github.vheins/local-memory-mcp",
6
6
  "type": "module",
@@ -70,7 +70,7 @@
70
70
  "eslint": "^10.2.0",
71
71
  "eslint-config-prettier": "^10.1.8",
72
72
  "eslint-plugin-prettier": "^5.5.5",
73
- "eslint-plugin-svelte": "^2.46.1",
73
+ "eslint-plugin-svelte": "^3.17.0",
74
74
  "fast-check": "^4.6.0",
75
75
  "globals": "^17.5.0",
76
76
  "prettier": "^3.8.2",