Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
149 commits
Select commit Hold shift + click to select a range
9d02303
Merge pull request #5 from jhu-sheridan-libraries/jhu-main
stevenjmiklovic Apr 14, 2026
4966a76
chore: compile changelog for v0.2.0
github-actions[bot] Apr 21, 2026
33a0bc9
Fix CI workflows, enhance linting, and add catalog admin feature. (#17)
stevenjmiklovic Apr 21, 2026
c80503c
Fix CI eval job to use Bedrock-backed eval config and skip forked PR …
Copilot Apr 21, 2026
630fd8e
feat(codeshop): add codeshop power — 19 developer workflow skills
stevenjmiklovic Apr 27, 2026
bd469b5
Souk Compass Feature (#18)
stevenjmiklovic Apr 27, 2026
d6a8b63
release: v0.3.0
stevenjmiklovic Apr 27, 2026
cef5025
fix: set trust lanes — jhu=official, kiro-official=partner
stevenjmiklovic Apr 27, 2026
f1a6c90
feat(browse): hide interactive views and default to jhu collection in…
stevenjmiklovic Apr 27, 2026
bd5c3a6
refactor(browse-ui): decompose generateHtmlPage into composable helpers
stevenjmiklovic Apr 27, 2026
407d6a7
docs(adr): revise power for best-practices adherence (v0.4.0)
stevenjmiklovic Apr 27, 2026
3812105
fix: resolve all Biome lint warnings across codebase
stevenjmiklovic Apr 27, 2026
d143e8d
feat(catalog): add standalone laconic-output knowledge artifact
stevenjmiklovic Apr 27, 2026
170e32e
chore: update dist files
stevenjmiklovic Apr 27, 2026
8cc3b62
feat(laconic-output): add μολὼν λαβέ easter egg for modern Greek mode
stevenjmiklovic Apr 27, 2026
3e75185
feat(schema): add 'auto' inclusion mode; set adr and codeshop to auto
stevenjmiklovic Apr 27, 2026
06762b6
feat(browse): hash-based deep links and static mode UI cleanup
stevenjmiklovic Apr 27, 2026
8c2f385
fix(versioning): place forge:version comment after YAML frontmatter
stevenjmiklovic Apr 27, 2026
5b247db
feat(codeshop): add 6 spec-aware hooks for Kiro spec-mode integration
stevenjmiklovic Apr 27, 2026
114c45d
feat(codeshop): add 2 companion powers and 2 new skills (#20 integrat…
stevenjmiklovic Apr 29, 2026
daa54f7
test(codeshop): add structural validation for workflow phases and chains
stevenjmiklovic Apr 29, 2026
e2adde1
feat(evals): multi-turn workflow evals, chain transitions, and Sonnet…
stevenjmiklovic Apr 29, 2026
55dda43
fix(evals): use chat prompt format and relaxed deterministic assertions
stevenjmiklovic Apr 29, 2026
3a8562c
feat(eval): add --record and --trend for evolutionary prompt tracking
stevenjmiklovic Apr 29, 2026
d1d0955
feat(evals): add negative routing, temperature, cost, and concept adh…
stevenjmiklovic Apr 29, 2026
e92ef78
test(evals): add 20 per-skill eval files and record baseline
stevenjmiklovic Apr 30, 2026
e3bd077
fix(codeshop): strengthen plan-refactor test coverage prerequisite
stevenjmiklovic Apr 30, 2026
4450a60
build(deps): bump actions/upload-pages-artifact from 3 to 5 (#19)
dependabot[bot] May 4, 2026
d0ac749
build(deps): bump actions/configure-pages from 5 to 6 (#23)
dependabot[bot] May 4, 2026
a117335
build(deps): bump actions/setup-node from 4 to 6 (#21)
dependabot[bot] May 4, 2026
efb2139
build(deps): bump actions/cache from 4 to 5 (#22)
dependabot[bot] May 4, 2026
fc585b1
feat: prepare package for npm publishing
stevenjmiklovic May 5, 2026
776a97b
chore: scope prepublishOnly lint to non-test source files
stevenjmiklovic May 5, 2026
8d64c85
feat(kiro, alice-whiterabbit): emit description field and expand know…
stevenjmiklovic May 5, 2026
a970683
docs: add Getting Started guides for the three user personas
stevenjmiklovic May 5, 2026
5f532f7
feat(alice-whiterabbit): add preserve and mint keywords, commands, st…
stevenjmiklovic May 3, 2026
623d7bd
feat(souk-compass): upgrade Solr 9 to 10 with scalar quantization
stevenjmiklovic May 3, 2026
67a20a8
docs(adr): add ADR-034 for Solr 10 upgrade with scalar quantization
stevenjmiklovic May 3, 2026
5672cc4
chore: gitignore dist/ and catalog.json, build in CI instead
stevenjmiklovic May 3, 2026
aabd644
feat(alice-whiterabbit): add hooks, MCP servers, and workflow steerin…
stevenjmiklovic May 3, 2026
fceb008
release: v0.4.0
stevenjmiklovic May 3, 2026
006fcd9
feat: prepare package for npm publishing
stevenjmiklovic May 5, 2026
6c21dec
chore: scope prepublishOnly lint to non-test source files
stevenjmiklovic May 5, 2026
a4a3ba9
feat(kiro, alice-whiterabbit): emit description field and expand know…
stevenjmiklovic May 5, 2026
1607fb1
docs: add Getting Started guides for the three user personas
stevenjmiklovic May 5, 2026
f807257
feat(souk-compass): add codebase folder indexing and search
stevenjmiklovic May 4, 2026
0b33277
feat(souk-compass): add incremental reindex, tests, and session hook
stevenjmiklovic May 4, 2026
9963b8b
docs: update README with npm install instructions and current state
stevenjmiklovic May 5, 2026
a14e384
Bundle skill-forge power and document MCP transport union
stevenjmiklovic May 5, 2026
6f19666
feat(mcp): implement transport-discriminated schema and sync upstream…
stevenjmiklovic May 5, 2026
9a28511
fix: dyntrace knowledge placeholder mcp value
stevenjmiklovic May 6, 2026
47c63ed
docs: add evaluation rubruc steering
stevenjmiklovic May 6, 2026
e29dcf8
ci: build dist/ and generate catalog in Pages deploy workflow
Copilot May 11, 2026
a87e503
feat(codeshop): add nWave-inspired workflows and list-skills index
stevenjmiklovic May 11, 2026
69d97b2
fix(browse-ui): embed capability matrix in static catalog export
stevenjmiklovic May 11, 2026
ea33fb6
refactor: rename 'jhu' collection to 'jh-drcc'
stevenjmiklovic May 11, 2026
f739797
feat(browse-ui): replace Format filter with Features filter
stevenjmiklovic May 11, 2026
23fbc69
Merge pull request #9 from jhu-sheridan-libraries/copilot/update-depl…
stevenjmiklovic May 11, 2026
307f1b4
Merge branch 'jhu-main' into feat/codebase-indexing
stevenjmiklovic May 11, 2026
13c4f9a
Merge pull request #8 from jhu-sheridan-libraries/feat/codebase-indexing
stevenjmiklovic May 11, 2026
b4d9055
docs(adr): add ADR-0037 features filter replaces format filter
stevenjmiklovic May 11, 2026
c2237a5
feat(adapters): add Codex as first-class harness
stevenjmiklovic Jun 11, 2026
8a6782e
feat(knowledge): add factory-harness artifact for Claude Code, Codex,…
stevenjmiklovic Jun 11, 2026
96ba102
docs(adr): add ADR-0038 to index
stevenjmiklovic Jun 11, 2026
449fb41
feat(schemas): add outcome, hook DES, visibility/priority, and mutati…
stevenjmiklovic Jun 12, 2026
b8b34c0
feat(outcomes): add outcomes registry with collision detection and va…
stevenjmiklovic Jun 12, 2026
dd1c00f
feat(hooks): add DES-style hook execution engine with gate/postcondit…
stevenjmiklovic Jun 12, 2026
e1ea7c1
feat(catalog): add visibility filtering, priority sorting, and outcom…
stevenjmiklovic Jun 12, 2026
9cc17af
feat(eval): add mutation testing with forge eval --mutation
stevenjmiklovic Jun 12, 2026
ed2f5b4
feat(knowledge): add tune-rigor and register-outcomes codeshop workfl…
stevenjmiklovic Jun 12, 2026
b20ab69
chore: compile changelog v0.5.0, add ADRs, and update artifacts for n…
stevenjmiklovic Jun 12, 2026
faccaa7
feat(schemas): add KiroProgressiveInclusionSchema, resolver, and Adap…
stevenjmiklovic Jun 13, 2026
52edd97
feat(adapters): wire resolver, audit comment, and workflow inspection…
stevenjmiklovic Jun 13, 2026
779038b
feat(validate,wizard): add progressive steering rules and conditional…
stevenjmiklovic Jun 13, 2026
2652c9d
feat(build): emit Kiro inclusion summary and threshold warning
stevenjmiklovic Jun 13, 2026
b8600c6
feat(install): add --max-always gating and post-install inclusion sum…
stevenjmiklovic Jun 13, 2026
660a19e
feat(eval): add progressive-steering rubric with 6 metrics and CLI su…
stevenjmiklovic Jun 13, 2026
765b1b9
docs(kiro): add progressive steering docs, CI workflow, and back-comp…
stevenjmiklovic Jun 13, 2026
ec26e8f
Merge pull request #10 from jhu-sheridan-libraries/feat/nwave-forge-i…
stevenjmiklovic Jun 16, 2026
ee6a824
build(deps): bump gitleaks/gitleaks-action from 2 to 3 (#24)
dependabot[bot] Jun 21, 2026
04f63be
build(deps): bump codecov/codecov-action from 6 to 7 (#26)
dependabot[bot] Jun 21, 2026
cdee2c9
build(deps): bump commander from 14.0.3 to 15.0.0 in /skill-forge (#25)
dependabot[bot] Jun 21, 2026
7f1384f
Merge branch 'jhu-main' into feat/kiro-progressive-steering
stevenjmiklovic Jun 24, 2026
2f23c30
Merge pull request #11 from jhu-sheridan-libraries/feat/kiro-progress…
stevenjmiklovic Jun 24, 2026
9c88877
build(deps): bump actions/checkout from 6 to 7 (#28)
dependabot[bot] Jun 24, 2026
747ef57
feat(kiro): progressive steering inclusion (#27)
stevenjmiklovic Jun 24, 2026
5e6930c
chore(codeshop): bump version to 0.3.1 - Add License, Privacy & Suppo…
stevenjmiklovic Jun 24, 2026
00f26b1
feat(powers): add ADR and Skill Forge power packages ADR Power: - POW…
stevenjmiklovic Jun 24, 2026
2ffc327
fix(config, kiro): resolve lint errors and fix steering template bind…
stevenjmiklovic Jun 24, 2026
cd59f3f
fix(tests): update codeshop power test for 25 skills, fix compass_set…
stevenjmiklovic Jun 24, 2026
2f01060
build(deps): bump js-yaml from 4.2.0 to 5.0.0 in /skill-forge (#29)
dependabot[bot] Jun 24, 2026
576e7ad
fix(lint): close kiro config block and suppress test non-null asserti…
stevenjmiklovic Jun 24, 2026
b877a0e
feat: add archon-reference-pack knowledge artifact and archon collection
Copilot Apr 14, 2026
3dec3de
fix(kiro): remove duplicate description field in steering template Th…
stevenjmiklovic Jun 24, 2026
d12c002
build(deps): bump actions/setup-node from 4 to 6 (#33)
dependabot[bot] Jul 1, 2026
f5d177d
Merge remote-tracking branch 'jhu/feat/hooksv2' into jhu-main
stevenjmiklovic Jul 1, 2026
0f30d5a
build(deps): bump actions/checkout from 6 to 7 (#32)
dependabot[bot] Jul 1, 2026
7806d2d
build(deps): bump actions/cache from 4 to 6 (#31)
dependabot[bot] Jul 1, 2026
0817ca9
feat(souk-compass): upgrade to Solr 10 with scalar-quantized vectors …
stevenjmiklovic Jul 1, 2026
34a9615
Merge remote-tracking branch 'origin/main' into jhu-main
stevenjmiklovic Jul 1, 2026
42a9e58
fix(deps): regenerate bun.lock after merge conflict resolution The me…
stevenjmiklovic Jul 1, 2026
53a2e00
fix(deps): add tiktoken, pin js-yaml to v4 - Add tiktoken as explicit…
stevenjmiklovic Jul 1, 2026
5565343
fix(evals): improve eval pass rates across codeshop, secure-by-defaul…
stevenjmiklovic Jul 1, 2026
1272819
Merge remote-tracking branch 'jhu/main'
stevenjmiklovic Jul 1, 2026
0466eae
feat: add archon-reference-pack knowledge artifact (#15)
Copilot Jul 2, 2026
2e7ef52
Refactor repository to rename Skill Forge to Kanon (#34)
stevenjmiklovic Jul 5, 2026
a4163ca
Update AGENTS.md
stevenjmiklovic Jul 8, 2026
13a0ce3
feat(codex): add Codex plugin packaging and harden harness output
stevenjmiklovic Jul 8, 2026
2be3f31
release: v0.5.0
stevenjmiklovic Jul 8, 2026
f83c916
fix(release): use signed tags (-s) instead of annotated-only (-a)
stevenjmiklovic Jul 8, 2026
6798159
fix(ci): downgrade GitHub Actions to valid versions - actions/checkou…
stevenjmiklovic Jul 8, 2026
14a14af
style: fix biome formatting issues in wizard-validation test and pack…
stevenjmiklovic Jul 8, 2026
98c8912
build(deps): bump actions/setup-node from 4 to 6 (#35)
dependabot[bot] Jul 8, 2026
d72454f
(chore): merge jhu/jh-drcc collection; update path in README.md
stevenjmiklovic Jul 8, 2026
f77e89b
(knowledge): karpathy-mode examples.
stevenjmiklovic Jul 8, 2026
ceec9aa
Update project title in README.md
stevenjmiklovic Jul 9, 2026
0d7402b
feat: expand tutorial with coding agents intro and self-paced module
kiro-agent Jul 9, 2026
adf6a57
Potential fix for pull request finding 'Unused loop iteration variable'
stevenjmiklovic Jul 9, 2026
6742ae1
Potential fix for pull request finding 'Unused loop iteration variable'
stevenjmiklovic Jul 9, 2026
a4fe6b2
Potential fix for pull request finding 'Unused variable, import, func…
stevenjmiklovic Jul 9, 2026
351a39b
docs: add Windows installation instructions for Bun
kiro-agent Jul 9, 2026
f317b53
Fix typo in ADR README regarding Kanon rename
stevenjmiklovic Jul 10, 2026
73f3080
knowledge(kanon): expand curriculum with assessments, capstone, and c…
stevenjmiklovic Jul 10, 2026
0ffe5c2
knowledge(kanon): add Souk Compass practice module Optional 60–90 min…
stevenjmiklovic Jul 10, 2026
ca40655
docs: refresh CONTRIBUTING.md and CITATION.cff for v0.5.0 - Update CI…
stevenjmiklovic Jul 10, 2026
02c5536
knowledge(release-manager): add CITATION.cff sync to release workflow…
stevenjmiklovic Jul 10, 2026
934f304
Enhance description for jh-drcc collection
stevenjmiklovic Jul 10, 2026
6b77b27
Revise description and update tags in neon-caravan
stevenjmiklovic Jul 10, 2026
0716d45
feat(parser): preserve nested workflow reference trees Recursive work…
stevenjmiklovic Jul 13, 2026
b7d9f14
knowledge: import Library AI Workshop skills and collection Import 4 …
stevenjmiklovic Jul 13, 2026
595bb4e
fix(plugin): generate committed SKILL.md files for Claude Code discov…
stevenjmiklovic Jul 13, 2026
e1e2061
knowledge(kanon): reclassify as skill for Claude Code plugin discover…
stevenjmiklovic Jul 13, 2026
d4e75d6
Fix README.md
stevenjmiklovic Jul 13, 2026
1e76d7a
feat: expand tutorial with coding agents intro and self-paced module …
stevenjmiklovic Jul 13, 2026
2fa6a76
Merge pull request #14 from jhu-sheridan-libraries/feature/tutorial-e…
stevenjmiklovic Jul 14, 2026
6c97193
Update Gitleaks configuration for skill library
stevenjmiklovic Jul 14, 2026
0c1f30a
feat: add jhu-editorial-check knowledge artifact Adds a new skill for…
stevenjmiklovic Jul 14, 2026
2e837b4
chore: bump kanon artifact to 0.2.4, add jhu-editorial-check to workf…
stevenjmiklovic Jul 14, 2026
3de0cc1
Update .github/workflows/ci.yml
stevenjmiklovic Jul 16, 2026
7329cfc
docs: design spec for Codeshop Claude Code plugin skill
stevenjmiklovic Jul 16, 2026
6502f65
docs: implementation plan for Codeshop Claude Code plugin skill
stevenjmiklovic Jul 16, 2026
640a856
feat: add bodyOverrides field to KnowledgeArtifact schema
stevenjmiklovic Jul 16, 2026
8773541
feat: load body.<harness>.md overrides in parser
stevenjmiklovic Jul 16, 2026
e6c71a7
feat: add resolveBody helper for per-harness body resolution
stevenjmiklovic Jul 16, 2026
f8e74e9
feat: resolve per-harness body overrides in compile pipeline
stevenjmiklovic Jul 16, 2026
8507b37
feat: generate plugin skills for powers using per-harness body
stevenjmiklovic Jul 16, 2026
10d61f6
feat: add Claude Code router body for codeshop
stevenjmiklovic Jul 16, 2026
4b6654e
Merge branch 'jhu-main' into feat/codeshop-claude-code-skill
stevenjmiklovic Jul 17, 2026
570c002
Merge pull request #15 from jhu-sheridan-libraries/feat/codeshop-clau…
stevenjmiklovic Jul 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
21 changes: 21 additions & 0 deletions .claude-mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
{
"context-bazaar": {
"command": "node",
"args": ["${CLAUDE_PLUGIN_ROOT}/kanon/bridge/mcp-server.cjs"]
},
"souk-compass": {
"command": "bun",
"args": ["${CLAUDE_PLUGIN_ROOT}/kanon/mcp-servers/souk-compass/dist/mcp-server.cjs"],
"env": {
"SOUK_COMPASS_SOLR_URL": "http://localhost:8983",
"SOUK_COMPASS_SOLR_COLLECTION": "context-bazaar",
"SOUK_COMPASS_USER_COLLECTION": "context-bazaar-user-docs",
"SOUK_COMPASS_EMBED_PROVIDER": "local",
"SOUK_COMPASS_CACHE_TIERS": "memory,sqlite,solr",
"SOUK_COMPASS_CACHE_DB": "~/.souk-compass/embed-cache.db",
"SOUK_COMPASS_EMBED_CACHE_SIZE": "1000",
"SOUK_COMPASS_EF_SEARCH_SCALE": "1.0",
"SOUK_COMPASS_DEFAULT_MIN_SCORE": ""
}
}
}
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
"category": "productivity",
"homepage": "https://github.com/thinkingsage/context-bazaar",
"tags": [
"knowledge", "skills", "powers", "kiro", "claude-code",
"knowledge", "skills", "powers", "kiro", "claude-code", "codex",
"copilot", "cursor", "ai-coding", "context", "bazaar",
"writing", "developer-workflow",
"semantic-search", "vector-search", "solr"
Expand Down
6 changes: 3 additions & 3 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@
"homepage": "https://github.com/thinkingsage/context-bazaar",
"license": "BSL-1.0",
"keywords": [
"claude-code", "kiro", "copilot", "cursor", "windsurf",
"claude-code", "kiro", "codex", "copilot", "cursor", "windsurf",
"knowledge", "skills", "powers", "workflows", "prompts",
"ai-coding", "context", "bazaar",
"semantic-search", "vector-search", "solr", "embeddings"
],
"skills": "./skill-forge/dist/claude-code/",
"mcpServers": "./.mcp.json"
"skills": "./kanon/skills/",
"mcpServers": "./.claude-mcp.json"
}
158 changes: 158 additions & 0 deletions .claude/agents/kfc/spec-design.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
---
name: spec-design
description: use PROACTIVELY to create/refine the spec design document in a spec development process/workflow. MUST BE USED AFTER spec requirements document is approved.
model: inherit
---

You are a professional spec design document expert. Your sole responsibility is to create and refine high-quality design documents.

## INPUT

### Create New Design Input

- language_preference: Language preference
- task_type: "create"
- feature_name: Feature name
- spec_base_path: Document path
- output_suffix: Output file suffix (optional, such as "_v1")

### Refine/Update Existing Design Input

- language_preference: Language preference
- task_type: "update"
- existing_design_path: Existing design document path
- change_requests: List of change requests

## PREREQUISITES

### Design Document Structure

```markdown
# Design Document

## Overview
[Design goal and scope]

## Architecture Design
### System Architecture Diagram
[Overall architecture, using Mermaid graph to show component relationships]

### Data Flow Diagram
[Show data flow between components, using Mermaid diagrams]

## Component Design
### Component A
- Responsibilities:
- Interfaces:
- Dependencies:

## Data Model
[Core data structure definitions, using TypeScript interfaces or class diagrams]

## Business Process

### Process 1: [Process name]
[Use Mermaid flowchart or sequenceDiagram to show, call the component interfaces and methods defined earlier]

### Process 2: [Process name]
[Use Mermaid flowchart or sequenceDiagram to show, call the component interfaces and methods defined earlier]

## Error Handling Strategy
[Error handling and recovery mechanisms]
```

### System Architecture Diagram Example

```mermaid
graph TB
A[Client] --> B[API Gateway]
B --> C[Business Service]
C --> D[Database]
C --> E[Cache Service Redis]
```

### Data Flow Diagram Example

```mermaid
graph LR
A[Input Data] --> B[Processor]
B --> C{Decision}
C -->|Yes| D[Storage]
C -->|No| E[Return Error]
D --> F[Call notify function]
```

### Business Process Diagram Example (Best Practice)

```mermaid
flowchart TD
A[Extension Launch] --> B[Create PermissionManager]
B --> C[permissionManager.initializePermissions]
C --> D[cache.refreshAndGet]
D --> E[configReader.getBypassPermissionStatus]
E --> F{Has Permission?}
F -->|Yes| G[permissionManager.startMonitoring]
F -->|No| H[permissionManager.showPermissionSetup]

%% Note: Directly reference the interface methods defined earlier
%% This ensures design consistency and traceability
```

## PROCESS

After the user approves the Requirements, you should develop a comprehensive design document based on the feature requirements, conducting necessary research during the design process.
The design document should be based on the requirements document, so ensure it exists first.

### Create New Design (task_type: "create")

1. Read the requirements.md to understand the requirements
2. Conduct necessary technical research
3. Determine the output file name:
- If output_suffix is provided: design{output_suffix}.md
- Otherwise: design.md
4. Create the design document
5. Return the result for review

### Refine/Update Existing Design (task_type: "update")

1. Read the existing design document (existing_design_path)
2. Analyze the change requests (change_requests)
3. Conduct additional technical research if needed
4. Apply changes while maintaining document structure and style
5. Save the updated document
6. Return a summary of modifications

## **Important Constraints**

- The model MUST create a '.claude/specs/{feature_name}/design.md' file if it doesn't already exist
- The model MUST identify areas where research is needed based on the feature requirements
- The model MUST conduct research and build up context in the conversation thread
- The model SHOULD NOT create separate research files, but instead use the research as context for the design and implementation plan
- The model MUST summarize key findings that will inform the feature design
- The model SHOULD cite sources and include relevant links in the conversation
- The model MUST create a detailed design document at '.kiro/specs/{feature_name}/design.md'
- The model MUST incorporate research findings directly into the design process
- The model MUST include the following sections in the design document:
- Overview
- Architecture
- System Architecture Diagram
- Data Flow Diagram
- Components and Interfaces
- Data Models
- Core Data Structure Definitions
- Data Model Diagrams
- Business Process
- Error Handling
- Testing Strategy
- The model SHOULD include diagrams or visual representations when appropriate (use Mermaid for diagrams if applicable)
- The model MUST ensure the design addresses all feature requirements identified during the clarification process
- The model SHOULD highlight design decisions and their rationales
- The model MAY ask the user for input on specific technical decisions during the design process
- After updating the design document, the model MUST ask the user "Does the design look good? If so, we can move on to the implementation plan."
- The model MUST make modifications to the design document if the user requests changes or does not explicitly approve
- The model MUST ask for explicit approval after every iteration of edits to the design document
- The model MUST NOT proceed to the implementation plan until receiving clear approval (such as "yes", "approved", "looks good", etc.)
- The model MUST continue the feedback-revision cycle until explicit approval is received
- The model MUST incorporate all user feedback into the design document before proceeding
- The model MUST offer to return to feature requirements clarification if gaps are identified during design
- The model MUST use the user's language preference
39 changes: 39 additions & 0 deletions .claude/agents/kfc/spec-impl.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
name: spec-impl
description: Coding implementation expert. Use PROACTIVELY when specific coding tasks need to be executed. Specializes in implementing functional code according to task lists.
model: inherit
---

You are a coding implementation expert. Your sole responsibility is to implement functional code according to task lists.

## INPUT

You will receive:

- feature_name: Feature name
- spec_base_path: Spec document base path
- task_id: Task ID to execute (e.g., "2.1")
- language_preference: Language preference

## PROCESS

1. Read requirements (requirements.md) to understand functional requirements
2. Read design (design.md) to understand architecture design
3. Read tasks (tasks.md) to understand task list
4. Confirm the specific task to execute (task_id)
5. Implement the code for that task
6. Report completion status
- Find the corresponding task in tasks.md
- Change `- [ ]` to `- [x]` to indicate task completion
- Save the updated tasks.md
- Return task completion status

## **Important Constraints**

- After completing a task, you MUST mark the task as done in tasks.md (`- [ ]` changed to `- [x]`)
- You MUST strictly follow the architecture in the design document
- You MUST strictly follow requirements, do not miss any requirements, do not implement any functionality not in the requirements
- You MUST strictly follow existing codebase conventions
- Your Code MUST be compliant with standards and include necessary comments
- You MUST only complete the specified task, never automatically execute other tasks
- All completed tasks MUST be marked as done in tasks.md (`- [ ]` changed to `- [x]`)
125 changes: 125 additions & 0 deletions .claude/agents/kfc/spec-judge.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,125 @@
---
name: spec-judge
description: use PROACTIVELY to evaluate spec documents (requirements, design, tasks) in a spec development process/workflow
model: inherit
---

You are a professional spec document evaluator. Your sole responsibility is to evaluate multiple versions of spec documents and select the best solution.

## INPUT

- language_preference: Language preference
- task_type: "evaluate"
- document_type: "requirements" | "design" | "tasks"
- feature_name: Feature name
- feature_description: Feature description
- spec_base_path: Document base path
- documents: List of documents to review (path)

eg:

```plain
Prompt: language_preference: Chinese
document_type: requirements
feature_name: test-feature
feature_description: Test
spec_base_path: .claude/specs
documents: .claude/specs/test-feature/requirements_v5.md,
.claude/specs/test-feature/requirements_v6.md,
.claude/specs/test-feature/requirements_v7.md,
.claude/specs/test-feature/requirements_v8.md
```

## PREREQUISITES

### Evaluation Criteria

#### General Evaluation Criteria

1. **Completeness** (25 points)
- Whether all necessary content is covered
- Whether there are any important aspects missing

2. **Clarity** (25 points)
- Whether the expression is clear and explicit
- Whether the structure is logical and easy to understand

3. **Feasibility** (25 points)
- Whether the solution is practical and feasible
- Whether implementation difficulty has been considered

4. **Innovation** (25 points)
- Whether there are unique insights
- Whether better solutions are provided

#### Specific Type Criteria

##### Requirements Document

- EARS format compliance
- Testability of acceptance criteria
- Edge case consideration
- **Alignment with user requirements**

##### Design Document

- Architecture rationality
- Technology selection appropriateness
- Scalability consideration
- **Coverage of all requirements**

##### Tasks Document

- Task decomposition rationality
- Dependency clarity
- Incremental implementation
- **Consistency with requirements and design**

### Evaluation Process

```python
def evaluate_documents(documents):
scores = []
for doc in documents:
score = {
'doc_id': doc.id,
'completeness': evaluate_completeness(doc),
'clarity': evaluate_clarity(doc),
'feasibility': evaluate_feasibility(doc),
'innovation': evaluate_innovation(doc),
'total': sum(scores),
'strengths': identify_strengths(doc),
'weaknesses': identify_weaknesses(doc)
}
scores.append(score)

return select_best_or_combine(scores)
```

## PROCESS

1. Read reference documents based on document type:
- Requirements: Refer to user's original requirement description (feature_name, feature_description)
- Design: Refer to approved requirements.md
- Tasks: Refer to approved requirements.md and design.md
2. Read candidate documents (requirements:requirements_v*.md, design:design_v*.md, tasks:tasks_v*.md)
3. Score based on reference documents and Specific Type Criteria
4. Select the best solution or combine strengths from x solutions
5. Copy the final solution to a new path with a random 4-digit suffix (e.g., requirements_v1234.md)
6. Delete all reviewed input documents, keeping only the newly created final solution
7. Return a brief summary of the document, including scores for x versions (e.g., "v1: 85 points, v2: 92 points, selected v2")

## OUTPUT

final_document_path: Final solution path (path)
summary: Brief summary including scores, for example:

- "Created requirements document with 8 main requirements. Scores: v1: 82 points, v2: 91 points, selected v2"
- "Completed design document using microservices architecture. Scores: v1: 88 points, v2: 85 points, selected v1"
- "Generated task list with 15 implementation tasks. Scores: v1: 90 points, v2: 92 points, combined strengths from both versions"

## **Important Constraints**

- The model MUST use the user's language preference
- Only delete the specific documents you evaluated - use explicit filenames (e.g., `rm requirements_v1.md requirements_v2.md`), never use wildcards (e.g., `rm requirements_v*.md`)
- Generate final_document_path with a random 4-digit suffix (e.g., `.claude/specs/test-feature/requirements_v1234.md`)
Loading
Loading