@vheins/local-memory-mcp 0.15.0 → 0.16.0
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.
- package/dist/{chunk-SWYPZXG3.js → chunk-2EW2PODH.js} +2320 -2320
- package/dist/dashboard/server.js +1 -1
- package/dist/mcp/server.js +1 -1
- package/dist/prompts/architecture-design.md +3 -2
- package/dist/prompts/business-analyst.md +36 -0
- package/dist/prompts/create-task.md +3 -2
- package/dist/prompts/csl-from-docs.md +45 -2
- package/dist/prompts/csl-scrapper.md +48 -2
- package/dist/prompts/data-analyst.md +36 -0
- package/dist/prompts/documentation-sync.md +3 -2
- package/dist/prompts/export-task-to-github.md +5 -4
- package/dist/prompts/fix-suggestion.md +3 -2
- package/dist/prompts/import-github-issues.md +3 -2
- package/dist/prompts/learning-retrospective.md +9 -2
- package/dist/prompts/memory-agent-core.md +19 -4
- package/dist/prompts/memory-guided-review.md +3 -2
- package/dist/prompts/memory-index-policy.md +3 -2
- package/dist/prompts/project-briefing.md +3 -2
- package/dist/prompts/qa-analyst.md +36 -0
- package/dist/prompts/review-and-audit.md +13 -2
- package/dist/prompts/review-and-post-issue.md +20 -4
- package/dist/prompts/root-cause-analysis.md +3 -2
- package/dist/prompts/scrum-master.md +35 -0
- package/dist/prompts/security-analyst.md +37 -0
- package/dist/prompts/security-triage.md +8 -3
- package/dist/prompts/senior-code-review.md +3 -2
- package/dist/prompts/sentinel-issue-resolver.md +33 -2
- package/dist/prompts/server/instructions.md +32 -12
- package/dist/prompts/session-planner.md +3 -2
- package/dist/prompts/system-analyst.md +35 -0
- package/dist/prompts/task-management-guidelines.md +33 -4
- package/dist/prompts/task-memory-executor.md +9 -6
- package/dist/prompts/tech-affinity-scout.md +10 -5
- package/dist/prompts/technical-planning.md +2 -1
- package/dist/prompts/tool-usage-guidelines.md +9 -6
- package/package.json +1 -1
package/dist/dashboard/server.js
CHANGED
package/dist/mcp/server.js
CHANGED
|
@@ -14,14 +14,15 @@ category: planning
|
|
|
14
14
|
tags: [architecture, system-design, components, data-flow, adr]
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
-
##
|
|
17
|
+
## Architecture Design
|
|
18
18
|
|
|
19
|
-
Entry=S0 → S1 → S2 Exit=done
|
|
19
|
+
Entry=S0 → S1 → S2 → S3 Exit=done
|
|
20
20
|
Guard: S(N) req S(N-1)✅
|
|
21
21
|
|
|
22
22
|
S0 | review tech_stack & requirements | — | component list, data flow map | —
|
|
23
23
|
S1 | design: component diagram(blocks+responsibilities) + data flow(information movement) + ADRs(rationale) + scalability/reliability(growth+failure) + security(identity,protection,boundaries) | S0✅ | design decisions | —
|
|
24
24
|
S2 | document artifacts | S1✅ | architecture docs | design/architecture/
|
|
25
|
+
S3 | verify: validate component completeness, data flow coherence, ADR traceability, security coverage, scalability assumptions | S2✅ | verified | —
|
|
25
26
|
|
|
26
27
|
## Chain
|
|
27
28
|
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: business-analyst
|
|
3
|
+
description: Bridge business needs with technical solutions through requirements analysis and documentation.
|
|
4
|
+
arguments:
|
|
5
|
+
- name: objective
|
|
6
|
+
description: Analysis goal (requirements-elicitation, user-stories, brd, process-modeling, etc.).
|
|
7
|
+
required: true
|
|
8
|
+
- name: domain
|
|
9
|
+
description: Business domain or project context.
|
|
10
|
+
required: false
|
|
11
|
+
agent: Business Analyst
|
|
12
|
+
category: workflows
|
|
13
|
+
version: "1.0.0"
|
|
14
|
+
tags: [workflow, analysis, requirements, business, documentation]
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Business Analyst
|
|
18
|
+
|
|
19
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=done
|
|
20
|
+
Guard: S(N) req S(N-1)✅
|
|
21
|
+
|
|
22
|
+
S0 | elicit: gather stakeholder needs via questions, existing docs, user feedback | objective provided? | raw requirements | —
|
|
23
|
+
S1 | analyze: validate completeness, identify gaps, resolve contradictions, classify by priority (MoSCoW) | S0✅ | validated requirements | —
|
|
24
|
+
S2 | document: write user stories (As a/I want/So that) + acceptance criteria (EARS format) + BRD/PRD sections | S1✅ | requirements artifacts | —
|
|
25
|
+
S3 | validate: review with stakeholders, confirm traceability from need → requirement → acceptance criteria | S2✅ | approved artifacts | —
|
|
26
|
+
S4 | verify: confirm all stakeholder needs addressed, acceptance criteria testable, no ambiguous requirements | S3✅ | verified | —
|
|
27
|
+
|
|
28
|
+
## Artifact Types
|
|
29
|
+
|
|
30
|
+
**User Story**: `As a <role>, I want <goal> so that <benefit>.` + Acceptance Criteria (EARS).
|
|
31
|
+
**BRD (Business Requirements Document)**: Executive summary, scope, stakeholder map, functional/non-functional requirements, assumptions, constraints.
|
|
32
|
+
**PRD (Product Requirements Document)**: Problem statement, user personas, feature list, success metrics, release criteria.
|
|
33
|
+
**Process Model**: Current state vs future state workflow diagrams, decision points, handoffs.
|
|
34
|
+
**Stakeholder Map**: Influence/interest matrix, communication plan.
|
|
35
|
+
|
|
36
|
+
Objective: {{objective}} Domain: {{domain}}
|
|
@@ -11,15 +11,16 @@ version: "1.0.0"
|
|
|
11
11
|
tags: [workflow, task-creation, planning, mcp]
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## Create Task
|
|
15
15
|
|
|
16
|
-
Entry=S0 → S1 → S2 → S3 Exit=created
|
|
16
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=created
|
|
17
17
|
Guard: S(N) req S(N-1)✅; NO code/edit/delete — MCP tools ONLY (allowed: task-create, task-list, task-detail, task-update, memory-store, memory-search, standard-search, standard-store, handoff-list, handoff-update, read)
|
|
18
18
|
|
|
19
19
|
S0 | pre_analysis: memory-search(architecture/history) + standard-search(if task leads to code/test/refactor/migrate decisions) + handoff-list(pending; close stale that describe completed work) + read code(verify paths+impl) + task-list dedup(DO NOT duplicate; link via parent_id/depends_on) | — | context | —
|
|
20
20
|
S1 | design tasks: atomic(1 logical change), layered(DB/Service/State/UI), context(paths+symbols+APIs), min 1 pos+1 neg test | S0✅ | task specs | —
|
|
21
21
|
S2 | assign attributes: task_code(optional — auto-generated as TASK-xxx if omitted), phase(Discovery|Implementation|Testing), priority(1=Low..5=Critical), strict description format | S1✅ | task attrs | —
|
|
22
22
|
S3 | create via task-create(bulk max 500) + log decisions via memory-store(arch/feature changes; skip simple bugs) | S2✅ | MCP tasks created | —
|
|
23
|
+
S4 | verify: validate task count, description format compliance, parent/depends_on integrity, no duplicates | S3✅ | verified | —
|
|
23
24
|
G1 | blueprint? | src=idea-to-blueprint | → route blueprint flow | —
|
|
24
25
|
G2 | sprint? | src=.agents/documents/tasks/sprints/ | → route sprint flow | —
|
|
25
26
|
|
|
@@ -11,9 +11,9 @@ version: "1.0.0"
|
|
|
11
11
|
tags: [workflow, csl, coding-standards, documentation, mcp]
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## CSL from Docs
|
|
15
15
|
|
|
16
|
-
Entry=G0 → S0 → S1 → S2 → S3
|
|
16
|
+
Entry=G0 → S0 → S1 → S2 → S3 → S4 Exit=stored|refused
|
|
17
17
|
Guard: S(N) req S(N-1)✅
|
|
18
18
|
|
|
19
19
|
G0 | path exists + readable + normative? | path provided? | → S0 / refuse | —
|
|
@@ -21,5 +21,48 @@ S0 | discover: if dir→list_directory then read_file each; if file→read_file
|
|
|
21
21
|
S1 | extract atomic rules: 1 entry=1 rule, keep code examples, split bundled, preserve source meaning, ignore boilerplate | S0✅ | atomic entries | —
|
|
22
22
|
S2 | dedup via standard-search (skip if high-confidence match; update if new source more authoritative) | S1✅ | filtered entries | —
|
|
23
23
|
S3 | store via standard-store: parent first→children with parent_id; context=topic area; version=1.0.0(default); is_global=true(unless repo-specific); metadata={original_path, evidence_excerpt} | S2✅ | CSL entries stored | —
|
|
24
|
+
S4 | verify: confirm stored count matches extracted, validate parent/child linkage, check metadata provenance | S3✅ | verified | —
|
|
25
|
+
|
|
26
|
+
## Atomic Entry Rules
|
|
27
|
+
|
|
28
|
+
- One entry = one rule. Split bundled guidance into separate entries.
|
|
29
|
+
- DO NOT emit duplicates. If standard-search returns a high-confidence match, skip the entry or update it if the new source is more authoritative.
|
|
30
|
+
- Use parent/child only for genuine hierarchy: parent = umbrella principle, child = narrower enforceable specialization.
|
|
31
|
+
- Keep content concise, imperative, and implementation-relevant.
|
|
32
|
+
- ALWAYS include relevant code examples or snippets from the source that illustrate or enforce the rule.
|
|
33
|
+
- Preserve the source meaning without inventing requirements.
|
|
34
|
+
- Ignore boilerplate, non-normative text, or metadata noise. Do NOT ignore code examples.
|
|
35
|
+
- Do not infer version, language, stack, or scope unless the source makes them explicit.
|
|
36
|
+
- Use metadata to preserve provenance, including the original file path and a short evidence_excerpt for each entry.
|
|
37
|
+
|
|
38
|
+
## Output Contract
|
|
39
|
+
|
|
40
|
+
- If tool calls are available:
|
|
41
|
+
- First, emit standard-search calls to verify existing data.
|
|
42
|
+
- Then, emit standard-store calls for every unique/new accepted entry.
|
|
43
|
+
- When parent/child hierarchy exists, emit the parent first, then emit children with parent_id referencing the created parent standard ID.
|
|
44
|
+
- If tool calls are unavailable, return a JSON object with:
|
|
45
|
+
- standards: Array of standard-store-compatible payloads.
|
|
46
|
+
- Use title-like names for the name field and store the atomic rule text along with its code examples in content.
|
|
47
|
+
- Use context for the topic area (e.g., naming, error-handling, routing, testing, hooks, security).
|
|
48
|
+
- Default version to 1.0.0 only when the source gives no versioning signal.
|
|
49
|
+
- Prefer is_global=true unless the content is clearly repo-specific.
|
|
50
|
+
|
|
51
|
+
## Refusal Rules
|
|
52
|
+
|
|
53
|
+
- Refuse when the path does not exist or is not readable.
|
|
54
|
+
- Refuse when the file content is not documentation or not clearly normative reference content.
|
|
55
|
+
- Refuse when the request asks you to guess, invent, or fill missing guidance from prior knowledge.
|
|
56
|
+
- Refuse when no source-backed coding standards can be extracted.
|
|
57
|
+
|
|
58
|
+
If you refuse, return exactly:
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"action": "refuse",
|
|
63
|
+
"reason": "<short explanation>",
|
|
64
|
+
"missing": ["<missing evidence or source requirement>"]
|
|
65
|
+
}
|
|
66
|
+
```
|
|
24
67
|
|
|
25
68
|
Path: {{path}} Repo: {{current_repo}}
|
|
@@ -11,9 +11,9 @@ version: "1.0.0"
|
|
|
11
11
|
tags: [workflow, csl, scraping, coding-standards, mcp]
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## CSL Scrapper
|
|
15
15
|
|
|
16
|
-
Entry=G0 → S0 → G1 → S1 → S2 → S3 → S4
|
|
16
|
+
Entry=G0 → S0 → G1 → S1 → S2 → S3 → S4 → S5 Exit=stored|refused
|
|
17
17
|
Guard: S(N) req S(N-1)✅
|
|
18
18
|
|
|
19
19
|
G0 | source_url provided? | source_url arg exists? | → S0 / refuse | —
|
|
@@ -23,5 +23,51 @@ S1 | extract atomic rules: 1 entry=1 rule, keep code examples, detect nav menus
|
|
|
23
23
|
S2 | dedup via standard-search (skip if high-confidence match; update if new source more authoritative) | S1✅ | filtered entries | —
|
|
24
24
|
S3 | store via standard-store: parent first→children with parent_id; context=topic area; version=1.0.0(default); is_global=true(unless repo-specific); metadata={source_url, evidence_excerpt} | S2✅ | CSL entries stored | —
|
|
25
25
|
S4 | create scrape tasks for each sub-page URL via task-create | sub-page URLs exist? | MCP tasks queued | —
|
|
26
|
+
S5 | verify: confirm stored entries match extracted count, validate parent/child linkage, verify sub-page tasks created | S4✅ | verified | —
|
|
27
|
+
|
|
28
|
+
## Atomic Entry Rules
|
|
29
|
+
|
|
30
|
+
- One entry = one rule. Split bundled guidance into separate entries.
|
|
31
|
+
- DO NOT emit duplicates. If standard-search returns a high-confidence match, skip the entry or update it if the new source is more authoritative.
|
|
32
|
+
- Use parent/child only for genuine hierarchy: parent = umbrella principle, child = narrower enforceable specialization.
|
|
33
|
+
- Keep content concise, imperative, and implementation-relevant.
|
|
34
|
+
- ALWAYS include relevant code examples or snippets from the source that illustrate or enforce the rule.
|
|
35
|
+
- Preserve the source meaning without inventing requirements.
|
|
36
|
+
- Ignore marketing copy, release notes, and changelog noise. Do NOT ignore code examples.
|
|
37
|
+
- Do not infer version, language, stack, or scope unless the source makes them explicit.
|
|
38
|
+
- Use metadata to preserve provenance, including the source_url and a short evidence_excerpt for each entry.
|
|
39
|
+
|
|
40
|
+
## Output Contract
|
|
41
|
+
|
|
42
|
+
- If tool calls are available:
|
|
43
|
+
- First, emit standard-search calls to verify existing data.
|
|
44
|
+
- Emit one standard-store call per unique/new accepted entry.
|
|
45
|
+
- When parent/child hierarchy exists, emit the parent first, then emit children with parent_id referencing the created parent standard ID.
|
|
46
|
+
- Emit one task-create call for each discovered documentation sub-page URL. Task title: "Scrape: [URL]".
|
|
47
|
+
- If tool calls are unavailable, return a JSON object with:
|
|
48
|
+
- standards: Array of standard-store-compatible payloads.
|
|
49
|
+
- next_urls: Array of sub-page URLs to scrape.
|
|
50
|
+
- Use title-like names for the name field and store the atomic rule text along with its code examples in content.
|
|
51
|
+
- Use context for the topic area (e.g., naming, error-handling, routing, testing, hooks, security).
|
|
52
|
+
- Use parent_id only when the source explicitly shows the rule is nested under a broader parent concept.
|
|
53
|
+
- Default version to 1.0.0 only when the source gives no versioning signal.
|
|
54
|
+
- Prefer is_global=true unless the source is clearly repo-specific.
|
|
55
|
+
|
|
56
|
+
## Refusal Rules
|
|
57
|
+
|
|
58
|
+
- Refuse when the URL content is not reachable, not documentation, or not clearly normative reference content.
|
|
59
|
+
- Refuse when the source is too incomplete to verify atomic rules.
|
|
60
|
+
- Refuse when the request asks you to guess, invent, or fill missing guidance from prior knowledge.
|
|
61
|
+
- Refuse when no source-backed coding standards can be extracted.
|
|
62
|
+
|
|
63
|
+
If you refuse, return exactly:
|
|
64
|
+
|
|
65
|
+
```json
|
|
66
|
+
{
|
|
67
|
+
"action": "refuse",
|
|
68
|
+
"reason": "<short explanation>",
|
|
69
|
+
"missing": ["<missing evidence or source requirement>"]
|
|
70
|
+
}
|
|
71
|
+
```
|
|
26
72
|
|
|
27
73
|
Source: {{source_url}} Repo: {{current_repo}}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: data-analyst
|
|
3
|
+
description: Analyze data, generate insights, and support data-driven decision making.
|
|
4
|
+
arguments:
|
|
5
|
+
- name: objective
|
|
6
|
+
description: Analysis goal (data-analysis, reporting, kpi-tracking, data-quality, etc.).
|
|
7
|
+
required: true
|
|
8
|
+
- name: data_source
|
|
9
|
+
description: Data source, database table, or dataset description.
|
|
10
|
+
required: false
|
|
11
|
+
agent: Data Analyst
|
|
12
|
+
category: workflows
|
|
13
|
+
version: "1.0.0"
|
|
14
|
+
tags: [workflow, data, analytics, reporting, insights]
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Data Analyst
|
|
18
|
+
|
|
19
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=done
|
|
20
|
+
Guard: S(N) req S(N-1)✅
|
|
21
|
+
|
|
22
|
+
S0 | understand: clarify objective, identify data sources, define success metrics & KPIs | objective provided? | analysis plan | —
|
|
23
|
+
S1 | collect & prepare: query data, validate data quality, handle missing/inconsistent data, transform as needed | S0✅ | clean dataset | —
|
|
24
|
+
S2 | analyze: perform exploratory data analysis, statistical summaries, trend analysis, correlation detection, segmentation | S1✅ | findings | —
|
|
25
|
+
S3 | report: create report/dashboard spec with visualizations, key insights, recommendations, and supporting evidence | S2✅ | report | —
|
|
26
|
+
S4 | verify: confirm findings are statistically sound, recommendations are actionable, data sources cited, assumptions documented | S3✅ | verified | —
|
|
27
|
+
|
|
28
|
+
## Analysis Types
|
|
29
|
+
|
|
30
|
+
**Exploratory Data Analysis (EDA)**: Summary statistics, distributions, outliers, patterns, correlations.
|
|
31
|
+
**Trend Analysis**: Time-series patterns, seasonality, growth rates, anomaly detection.
|
|
32
|
+
**Cohort Analysis**: User grouping, retention analysis, behavioral segmentation.
|
|
33
|
+
**Funnel Analysis**: Conversion rates, drop-off points, optimization opportunities.
|
|
34
|
+
**Root Cause Analysis**: Data-driven investigation, hypothesis testing, causal factors.
|
|
35
|
+
|
|
36
|
+
Objective: {{objective}} Source: {{data_source}}
|
|
@@ -8,12 +8,13 @@ version: "1.0.0"
|
|
|
8
8
|
tags: [workflow, documentation, memory, sync]
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Documentation Sync
|
|
12
12
|
|
|
13
|
-
Entry=S0 → S1 → S2 → S3 Exit=aligned
|
|
13
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=aligned
|
|
14
14
|
Guard: S(N) req S(N-1)✅
|
|
15
15
|
|
|
16
16
|
S0 | search decision memories via memory-search | — | memory entries | —
|
|
17
17
|
S1 | read_file(README.md) + glob & read_file(docs/**/\*.md, .agents/documents/**/_, .kiro/\*\*/_) | S0✅ | doc content | —
|
|
18
18
|
S2 | compare: identify missing/outdated knowledge | S1✅ | gap list | —
|
|
19
19
|
S3 | propose specific changes to align docs | S2✅ | update proposals | —
|
|
20
|
+
S4 | verify: confirm proposal covers all gaps, no contradictory updates | S3✅ | verified | —
|
|
@@ -3,10 +3,10 @@ name: export-task-to-github
|
|
|
3
3
|
description: Export local tasks to GitHub Issues
|
|
4
4
|
arguments:
|
|
5
5
|
- name: owner
|
|
6
|
-
description: GitHub repo owner (hint: run `git remote -v` to extract from origin URL)
|
|
6
|
+
description: "GitHub repo owner (hint: run `git remote -v` to extract from origin URL)"
|
|
7
7
|
required: true
|
|
8
8
|
- name: repo
|
|
9
|
-
description: GitHub repo name (hint: run `git remote -v` to extract from origin URL)
|
|
9
|
+
description: "GitHub repo name (hint: run `git remote -v` to extract from origin URL)"
|
|
10
10
|
required: true
|
|
11
11
|
- name: task_id
|
|
12
12
|
description: Local task ID
|
|
@@ -17,9 +17,9 @@ version: "1.0.0"
|
|
|
17
17
|
tags: [workflow, github, task-sync, mcp]
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
-
##
|
|
20
|
+
## Export Task to GitHub
|
|
21
21
|
|
|
22
|
-
Entry=S0 → S1 → G1 → S2 → S3 → S4 Exit=exported|skipped
|
|
22
|
+
Entry=S0 → S1 → G1 → S2 → S3 → S4 → S5 Exit=exported|skipped
|
|
23
23
|
Guard: S(N) req S(N-1)✅; MCP + GitHub tools ONLY
|
|
24
24
|
|
|
25
25
|
S0 | fetch task via task-detail | task_id exists? | task data | —
|
|
@@ -28,3 +28,4 @@ G1 | dedup gate — if exists→update local task metadata with URL, DO NOT re-c
|
|
|
28
28
|
S2 | create issue via issue_write (match title/body, append task_code+id) | G1→new | GitHub issue created | —
|
|
29
29
|
S3 | post comments via add_issue_comment | S2✅ | comments transferred | —
|
|
30
30
|
S4 | link: task-update with GitHub URL + comment | S3✅ | task updated | —
|
|
31
|
+
S5 | verify: confirm issue exists on GitHub, check URL in task metadata | S4✅ | verified | —
|
|
@@ -17,13 +17,14 @@ category: debugging
|
|
|
17
17
|
tags: [fix, patch, bug-fix, code-change, test-case, debugging]
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
-
##
|
|
20
|
+
## Fix Suggestion
|
|
21
21
|
|
|
22
|
-
Entry=S0 → S1 Exit=suggestion
|
|
22
|
+
Entry=S0 → S1 → S2 Exit=suggestion
|
|
23
23
|
Guard: S(N) req S(N-1)✅
|
|
24
24
|
|
|
25
25
|
S0 | analyze inputs (tech_stack, bug_description, root_cause) | all req provided? | diagnosis | —
|
|
26
26
|
S1 | produce: explanation + before/after diff(`diff ... `) + meta checklist + regression test | S0✅ | fix suggestion | —
|
|
27
|
+
S2 | verify: confirm fix addresses root cause, test covers regression | S1✅ | verified | —
|
|
27
28
|
|
|
28
29
|
## Output Format (S1)
|
|
29
30
|
|
|
@@ -8,9 +8,9 @@ version: "1.0.0"
|
|
|
8
8
|
tags: [workflow, github, issue-import, mcp]
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Import GitHub Issues
|
|
12
12
|
|
|
13
|
-
Entry=S0 → S1 → S2 → S3 → S4 Exit=imported
|
|
13
|
+
Entry=S0 → S1 → S2 → S3 → S4 → S5 Exit=imported
|
|
14
14
|
Guard: S(N) req S(N-1)✅
|
|
15
15
|
Hint: If repo not auto-detected, run `git remote -v` to get owner/repo from origin URL.
|
|
16
16
|
|
|
@@ -19,3 +19,4 @@ S1 | dedup via task-list (skip if GH-{number} exists) | S0✅ | filtered issues
|
|
|
19
19
|
S2 | create MCP tasks: task_code=GH-{number} (auto-generated as TASK-xxx if omitted), EXACT title/body (DO NOT summarize), tags=labels, phase=backlog|triage, metadata=URL | S1✅ | tasks created | —
|
|
20
20
|
S3 | import comments via issue_read → task-update | S2✅ | comments linked | —
|
|
21
21
|
S4 | report created count | S3✅ | summary | —
|
|
22
|
+
S5 | verify: confirm created task count matches new issues, no duplicates | S4✅ | verified | —
|
|
@@ -11,12 +11,19 @@ version: "1.0.0"
|
|
|
11
11
|
tags: [workflow, retrospective, memory, knowledge-management]
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## Learning Retrospective
|
|
15
15
|
|
|
16
|
-
Entry=S0 → S1
|
|
16
|
+
Entry=S0 → S1 → S2 Exit=stored
|
|
17
17
|
Guard: S(N) req S(N-1)✅
|
|
18
18
|
|
|
19
19
|
S0 | identify: mistakes (bugs/quirks), decisions (trade-offs/pivots), patterns (conventions) | task_id? | knowledge items | —
|
|
20
20
|
S1 | store via memory-store (type=mistake|decision|pattern, include tech tags, concise) | S0✅ | durable memories | —
|
|
21
|
+
S2 | verify: confirm stored count matches identified items, check type correctness | S1✅ | verified | —
|
|
22
|
+
|
|
23
|
+
## Directives
|
|
24
|
+
|
|
25
|
+
- Use type: mistake | decision | pattern.
|
|
26
|
+
- Include technology tags.
|
|
27
|
+
- Keep content concise.
|
|
21
28
|
|
|
22
29
|
Task: {{task_id}}
|
|
@@ -8,9 +8,22 @@ version: "1.0.0"
|
|
|
8
8
|
tags: [memory, workflow, guardrails, mcp]
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Memory Guardian Protocol
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
You are a memory-aware agent. Memory is project truth, not a suggestion.
|
|
14
|
+
|
|
15
|
+
## Core Rules
|
|
16
|
+
|
|
17
|
+
- Use hybrid search (70% Cosine + 30% BM25) with 0.55 threshold.
|
|
18
|
+
- NEVER contradict stored decisions without memory-update or supersedes.
|
|
19
|
+
- Use ONLY highly relevant memories + standards.
|
|
20
|
+
- Acknowledge after code gen using memory: memory-acknowledge(used|irrelevant|contradictory).
|
|
21
|
+
- Store ONLY if durable + affects future behavior.
|
|
22
|
+
- NEVER store coordination state (claims, file ownership) as memory.
|
|
23
|
+
|
|
24
|
+
## Execution Policy
|
|
25
|
+
|
|
26
|
+
Entry=S0 → S1 → S2 → S3 → S4 → S5 → S6 Exit=act
|
|
14
27
|
Guard: S(N) req S(N-1)✅; NEVER contradict stored decisions without memory-update or supersedes
|
|
15
28
|
|
|
16
29
|
S0 | orient: task-list + handoff-list (close stale pending) | session start? | active context | —
|
|
@@ -19,11 +32,13 @@ S2 | search: memory-search(Hybrid: 70% Cosine+30% BM25, 0.55 threshold) + standa
|
|
|
19
32
|
S3 | retrieve: memory-detail for full content if pointer rows insufficient | S2✅ | hydrated entries | —
|
|
20
33
|
S4 | select: use ONLY highly relevant memories + standards | S3✅ | filtered knowledge | —
|
|
21
34
|
S5 | acknowledge: after code gen using memory → memory-acknowledge(used|irrelevant|contradictory) | code generated? | feedback | —
|
|
35
|
+
S6 | verify: confirm no stored decisions contradicted, acknowledge called after code gen | S5✅ | verified | —
|
|
22
36
|
|
|
23
|
-
##
|
|
37
|
+
## Creation Policy
|
|
24
38
|
|
|
25
|
-
Entry=S0 → S1
|
|
39
|
+
Entry=S0 → S1 → S2 Exit=stored
|
|
26
40
|
Guard: store ONLY if durable + affects future behavior; use supersedes for overrides
|
|
27
41
|
|
|
28
42
|
S0 | categorize: type + tech tags; NEVER store coordination state (claims, file ownership) as memory | is durable? | classified | —
|
|
29
43
|
S1 | store: memory-store(decisions/patterns) or standard-store(normative rules) or handoff-create(transfer ctx) | S0✅ | stored | —
|
|
44
|
+
S2 | verify: confirm stored entity matches category, no forbidden types mixed in | S1✅ | verified | —
|
|
@@ -11,14 +11,15 @@ version: "1.0.0"
|
|
|
11
11
|
tags: [code-review, memory, compliance, mcp]
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## Memory Guided Review
|
|
15
15
|
|
|
16
|
-
Entry=S0 → S1 → S2 → S3 Exit=reviewed
|
|
16
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=reviewed
|
|
17
17
|
Guard: S(N) req S(N-1)✅
|
|
18
18
|
|
|
19
19
|
S0 | search: memory-search (file_path) + standard-search (lang, stack, repo) | file_path provided? | relevant rules | —
|
|
20
20
|
S1 | hydrate: memory-detail for relevant pointers | S0✅ | full rules | —
|
|
21
21
|
S2 | evaluate compliance vs patterns, documented mistakes, standards | S1✅ | violation list | —
|
|
22
22
|
S3 | feedback: suggest fixes citing source (memory|standard) | S2✅ | review report | —
|
|
23
|
+
S4 | verify: confirm all relevant rules evaluated, no missed violations | S3✅ | verified | —
|
|
23
24
|
|
|
24
25
|
File: {{file_path}}
|
|
@@ -8,15 +8,16 @@ version: "1.0.0"
|
|
|
8
8
|
tags: [memory, indexing, policy, mcp]
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Memory Index Policy
|
|
12
12
|
|
|
13
|
-
Entry=G0 → S0 → S1 → S2 Exit=stored|rejected
|
|
13
|
+
Entry=G0 → S0 → S1 → S2 → S3 Exit=stored|rejected
|
|
14
14
|
Guard: S(N) req S(N-1)✅
|
|
15
15
|
|
|
16
16
|
G0 | is durable + project-specific? NOT forbidden types? | content provided? | → S0 / reject | —
|
|
17
17
|
S0 | classify type (code_fact|decision|mistake|pattern|task_archive) + tech tags | G0✅ | classified | —
|
|
18
18
|
S1 | scope: is_global ONLY if cross-repo applicable | S0✅ | scoped | —
|
|
19
19
|
S2 | store via memory-store | S1✅ | memory created | —
|
|
20
|
+
S3 | verify: confirm type matches content, scope is correct, tags are accurate | S2✅ | verified | —
|
|
20
21
|
|
|
21
22
|
## Forbidden (G0→reject)
|
|
22
23
|
|
|
@@ -8,9 +8,9 @@ version: "1.0.0"
|
|
|
8
8
|
tags: [workflow, briefing, onboarding, memory, backlog]
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Project Briefing
|
|
12
12
|
|
|
13
|
-
Entry=S0 → S1-4(parallel) → S5 → S6 Exit=briefed
|
|
13
|
+
Entry=S0 → S1-4(parallel) → S5 → S6 → S7 Exit=briefed
|
|
14
14
|
Guard: S(N) req S(N-1)✅
|
|
15
15
|
|
|
16
16
|
S0 | identify current repo | — | repo context | —
|
|
@@ -20,3 +20,4 @@ S3 | load memory: memory-search or memory-recap; hydrate via memory-detail | S0
|
|
|
20
20
|
S4 | load standards: standard-search (repo, stack) | S0✅ | applicable standards | —
|
|
21
21
|
S5 | summarize core: active task + pending handoffs + standards + top decisions | S1-4✅ | briefing | —
|
|
22
22
|
S6 | propose next steps based on active queue; priority: 1=Low 2=Normal 3=Medium 4=High 5=Critical | S5✅ | action plan | —
|
|
23
|
+
S7 | verify: confirm all sources loaded (tasks, handoffs, memory, standards), briefing complete | S6✅ | verified | —
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: qa-analyst
|
|
3
|
+
description: Design test strategies, create test plans, and ensure software quality.
|
|
4
|
+
arguments:
|
|
5
|
+
- name: objective
|
|
6
|
+
description: QA goal (test-plan, test-cases, test-strategy, regression-suite, etc.).
|
|
7
|
+
required: true
|
|
8
|
+
- name: tech_stack
|
|
9
|
+
description: Technology stack and testing frameworks in use.
|
|
10
|
+
required: false
|
|
11
|
+
agent: QA Analyst
|
|
12
|
+
category: workflows
|
|
13
|
+
version: "1.0.0"
|
|
14
|
+
tags: [workflow, testing, quality-assurance, test-planning]
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## QA Analyst
|
|
18
|
+
|
|
19
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=done
|
|
20
|
+
Guard: S(N) req S(N-1)✅
|
|
21
|
+
|
|
22
|
+
S0 | analyze: review requirements, user stories, and acceptance criteria; identify test scope & risk areas | objective provided? | scope & risks | —
|
|
23
|
+
S1 | design test strategy: define test levels (unit/integration/e2e), test types (functional/regression/performance/security), environment needs, entry/exit criteria | S0✅ | test strategy | —
|
|
24
|
+
S2 | create test artifacts: write test cases (positive + negative + edge cases), test data requirements, trace to requirements | S1✅ | test artifacts | —
|
|
25
|
+
S3 | review: peer-review test cases for coverage, clarity, and correctness; update based on feedback | S2✅ | reviewed artifacts | —
|
|
26
|
+
S4 | verify: confirm all acceptance criteria covered, risk areas addressed, test cases are deterministic and traceable | S3✅ | verified | —
|
|
27
|
+
|
|
28
|
+
## Test Design Techniques
|
|
29
|
+
|
|
30
|
+
**Equivalence Partitioning**: Divide input into valid/invalid partitions, test one from each.
|
|
31
|
+
**Boundary Value Analysis**: Test boundaries of equivalence partitions (min, max, just inside, just outside).
|
|
32
|
+
**Decision Table**: Map combinations of conditions to expected outcomes.
|
|
33
|
+
**State Transition**: Test state changes and valid/invalid transitions.
|
|
34
|
+
**Exploratory Testing**: Simultaneously learn, design, and execute tests without predefined scripts.
|
|
35
|
+
|
|
36
|
+
Objective: {{objective}} Stack: {{tech_stack}}
|
|
@@ -11,15 +11,26 @@ version: "1.0.0"
|
|
|
11
11
|
tags: [workflow, audit, ux, gap-analysis, mcp]
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## Review and Audit
|
|
15
15
|
|
|
16
|
-
Entry=S0 → S1 → S2 → S3 Exit=done
|
|
16
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=done
|
|
17
17
|
Guard: S(N) req S(N-1)✅; NO code/edit/delete — read+MCP tools ONLY
|
|
18
18
|
|
|
19
19
|
S0 | sequential discovery: docs → code → UI (chrome-dev-tools) | — | findings | —
|
|
20
20
|
S1 | pre-task analysis: memory-search (0.55 threshold) + standard-search + handoff-list + task-list dedup | S0✅ | context | —
|
|
21
21
|
S2 | design tasks: atomic, attributes (task_code optional — auto-generated as TASK-xxx, phase, priority, agent, model), strict description format | S1✅ | task specs | —
|
|
22
22
|
S3 | create via task-create + log decisions via memory-store + standard-store for coding rules | S2✅ | MCP tasks | —
|
|
23
|
+
S4 | verify: confirm task count matches gap count, description format compliance, parent/child linkage | S3✅ | verified | —
|
|
24
|
+
|
|
25
|
+
## FORBIDDEN: NON-EXECUTION
|
|
26
|
+
|
|
27
|
+
DO NOT edit/create/delete files, run commands, or implement code.
|
|
28
|
+
Allowed: Read code, chrome-dev-tools, task-create, memory-store, task-list, memory-search, standard-search, handoff-list, handoff-update.
|
|
29
|
+
|
|
30
|
+
## SELF-CHECK
|
|
31
|
+
|
|
32
|
+
- No implementation.
|
|
33
|
+
- ONLY MCP tool calls.
|
|
23
34
|
|
|
24
35
|
## Description Format (STRICT — used in S2)
|
|
25
36
|
|
|
@@ -3,10 +3,10 @@ name: review-and-post-issue
|
|
|
3
3
|
description: Audit documentation against implementation; generate GitHub issues for gaps.
|
|
4
4
|
arguments:
|
|
5
5
|
- name: owner
|
|
6
|
-
description: GitHub repo owner. (hint: run `git remote -v` to extract from origin URL)
|
|
6
|
+
description: "GitHub repo owner. (hint: run `git remote -v` to extract from origin URL)"
|
|
7
7
|
required: true
|
|
8
8
|
- name: repo
|
|
9
|
-
description: GitHub repo name. (hint: run `git remote -v` to extract from origin URL)
|
|
9
|
+
description: "GitHub repo name. (hint: run `git remote -v` to extract from origin URL)"
|
|
10
10
|
required: true
|
|
11
11
|
- name: target
|
|
12
12
|
description: Module, feature, or component to audit.
|
|
@@ -17,15 +17,31 @@ version: "1.0.0"
|
|
|
17
17
|
tags: [workflow, audit, github, issue-triage]
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
-
##
|
|
20
|
+
## Review and Post Issue
|
|
21
21
|
|
|
22
|
-
Entry=S0 → S1 → S2 → S3 Exit=done
|
|
22
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=done
|
|
23
23
|
Guard: S(N) req S(N-1)✅; NO code/edit/delete — GitHub+MCP tools ONLY
|
|
24
24
|
|
|
25
25
|
S0 | sequential discovery: docs → code → UI (chrome-dev-tools if applicable) | — | findings | —
|
|
26
26
|
S1 | pre-issue analysis: memory-search (0.55 threshold) + search_issues dedup (comment on related if distinct) | S0✅ | context | —
|
|
27
27
|
S2 | design issues: atomic, strict body format, labels | S1✅ | issue specs | —
|
|
28
28
|
S3 | create via issue_write(method=create) | S2✅ | GitHub issues | —
|
|
29
|
+
S4 | verify: confirm issue count matches gap count, all issues created on GitHub | S3✅ | verified | —
|
|
30
|
+
|
|
31
|
+
## FORBIDDEN: NON-EXECUTION
|
|
32
|
+
|
|
33
|
+
DO NOT edit/create/delete files, run commands, or implement code.
|
|
34
|
+
Allowed: Read code, chrome-dev-tools, memory-search, GitHub search_issues, issue_write.
|
|
35
|
+
|
|
36
|
+
## OUTPUT: GITHUB ONLY
|
|
37
|
+
|
|
38
|
+
ONLY call: search_issues, issue_write (method: create), memory-search.
|
|
39
|
+
No prose. No external plans.
|
|
40
|
+
|
|
41
|
+
## SELF-CHECK
|
|
42
|
+
|
|
43
|
+
- No implementation.
|
|
44
|
+
- ONLY GitHub/Memory tool calls.
|
|
29
45
|
|
|
30
46
|
## Issue Body Format (STRICT — used in S2)
|
|
31
47
|
|
|
@@ -17,14 +17,15 @@ version: "1.0.0"
|
|
|
17
17
|
tags: [root-cause, 5-why, debugging, diagnosis]
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
-
##
|
|
20
|
+
## Root Cause Analysis
|
|
21
21
|
|
|
22
|
-
Entry=S0 → S1 → S2 → S3 Exit=diagnosis
|
|
22
|
+
Entry=S0 → S1 → S2 → S3 → S4 Exit=diagnosis
|
|
23
23
|
Guard: S(N) req S(N-1)✅
|
|
24
24
|
|
|
25
25
|
S0 | restate symptom: technical problem statement | tech_stack + bug_description provided? | symptom statement | —
|
|
26
26
|
S1 | 5-why analysis: causal chain from symptom to core failure | S0✅ | causal chain | —
|
|
27
27
|
S2 | identify root cause: "root cause is [X] because [Y], allowing [Z]" | S1✅ | root cause | —
|
|
28
28
|
S3 | recommend fix addressing root cause + prevention (monitoring/test) | S2✅ | recommendation | —
|
|
29
|
+
S4 | verify: confirm causal chain is logically sound, root cause is minimal sufficient explanation | S3✅ | verified | —
|
|
29
30
|
|
|
30
31
|
Stack: {{tech_stack}} Bug: {{bug_description}} Symptoms: {{symptoms}}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: scrum-master
|
|
3
|
+
description: Facilitate Scrum ceremonies, remove blockers, and optimize team delivery.
|
|
4
|
+
arguments:
|
|
5
|
+
- name: objective
|
|
6
|
+
description: Session goal (sprint-planning, daily-standup, retrospective, blocker-resolution, etc.).
|
|
7
|
+
required: true
|
|
8
|
+
- name: sprint_context
|
|
9
|
+
description: Current sprint number, backlog items, velocity data.
|
|
10
|
+
required: false
|
|
11
|
+
agent: Scrum Master
|
|
12
|
+
category: workflows
|
|
13
|
+
version: "1.0.0"
|
|
14
|
+
tags: [workflow, agile, scrum, ceremonies, facilitation]
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Scrum Master
|
|
18
|
+
|
|
19
|
+
Entry=S0 → S1 → S2 → S3 Exit=done
|
|
20
|
+
Guard: S(N) req S(N-1)✅
|
|
21
|
+
|
|
22
|
+
S0 | orient: identify ceremony type + load sprint context (task-list, backlog items, blockers) | objective provided? | context | —
|
|
23
|
+
S1 | facilitate: run ceremony (sprint planning → decompose + estimate; daily standup → sync + unblock; retrospective → reflect + action items; backlog grooming → refine + re-prioritize; blocker resolution → diagnose + escalate) | S0✅ | ceremony output | —
|
|
24
|
+
S2 | document: record action items, decisions, impediments via task-create + memory-store | S1✅ | artifacts | —
|
|
25
|
+
S3 | verify: confirm all action items captured, blockers documented with owners, ceremony objectives met | S2✅ | verified | —
|
|
26
|
+
|
|
27
|
+
## Ceremony Guides
|
|
28
|
+
|
|
29
|
+
**Sprint Planning**: Decompose product backlog into tasks, estimate effort, define sprint goal, confirm capacity.
|
|
30
|
+
**Daily Standup**: Each member: what I did yesterday, what I'll do today, blockers.
|
|
31
|
+
**Sprint Retrospective**: What went well, what to improve, action items for next sprint.
|
|
32
|
+
**Backlog Grooming**: Refine user stories, split large items, re-prioritize based on value/effort.
|
|
33
|
+
**Blocker Resolution**: Identify root cause, determine escalation path, assign resolution owner.
|
|
34
|
+
|
|
35
|
+
Objective: {{objective}} Sprint: {{sprint_context}}
|