ai-devkit 0.14.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/README.md +6 -0
- package/dist/cli.js +10 -1
- package/dist/cli.js.map +1 -1
- package/dist/commands/agent.d.ts.map +1 -1
- package/dist/commands/agent.js +43 -17
- package/dist/commands/agent.js.map +1 -1
- package/dist/commands/install.d.ts +7 -0
- package/dist/commands/install.d.ts.map +1 -0
- package/dist/commands/install.js +74 -0
- package/dist/commands/install.js.map +1 -0
- package/dist/commands/phase.js +1 -1
- package/dist/commands/phase.js.map +1 -1
- package/dist/lib/Config.d.ts +3 -1
- package/dist/lib/Config.d.ts.map +1 -1
- package/dist/lib/Config.js +39 -6
- package/dist/lib/Config.js.map +1 -1
- package/dist/lib/SkillManager.d.ts.map +1 -1
- package/dist/lib/SkillManager.js +8 -2
- package/dist/lib/SkillManager.js.map +1 -1
- package/dist/lib/TemplateManager.d.ts.map +1 -1
- package/dist/lib/TemplateManager.js +1 -12
- package/dist/lib/TemplateManager.js.map +1 -1
- package/dist/services/config/config.service.d.ts +6 -0
- package/dist/services/config/config.service.d.ts.map +1 -0
- package/dist/services/config/config.service.js +55 -0
- package/dist/services/config/config.service.js.map +1 -0
- package/dist/services/install/install.service.d.ts +19 -0
- package/dist/services/install/install.service.d.ts.map +1 -0
- package/dist/services/install/install.service.js +125 -0
- package/dist/services/install/install.service.js.map +1 -0
- package/dist/templates/commands/capture-knowledge.md +7 -5
- package/dist/templates/commands/check-implementation.md +7 -4
- package/dist/templates/commands/code-review.md +7 -4
- package/dist/templates/commands/debug.md +7 -4
- package/dist/templates/commands/execute-plan.md +7 -4
- package/dist/templates/commands/new-requirement.md +7 -6
- package/dist/templates/commands/remember.md +6 -4
- package/dist/templates/commands/review-design.md +13 -10
- package/dist/templates/commands/review-requirements.md +11 -8
- package/dist/templates/commands/simplify-implementation.md +6 -3
- package/dist/templates/commands/update-planning.md +6 -3
- package/dist/templates/commands/writing-test.md +8 -5
- package/dist/templates/templates/commands/capture-knowledge.md +7 -5
- package/dist/templates/templates/commands/check-implementation.md +7 -4
- package/dist/templates/templates/commands/code-review.md +7 -4
- package/dist/templates/templates/commands/debug.md +7 -4
- package/dist/templates/templates/commands/execute-plan.md +7 -4
- package/dist/templates/templates/commands/new-requirement.md +7 -6
- package/dist/templates/templates/commands/remember.md +6 -4
- package/dist/templates/templates/commands/review-design.md +13 -10
- package/dist/templates/templates/commands/review-requirements.md +11 -8
- package/dist/templates/templates/commands/simplify-implementation.md +6 -3
- package/dist/templates/templates/commands/update-planning.md +6 -3
- package/dist/templates/templates/commands/writing-test.md +8 -5
- package/dist/types.d.ts +6 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/dist/util/config.d.ts +8 -0
- package/dist/util/config.d.ts.map +1 -0
- package/dist/util/config.js +100 -0
- package/dist/util/config.js.map +1 -0
- package/dist/util/process.d.ts +1 -1
- package/dist/util/process.d.ts.map +1 -1
- package/package.json +5 -3
- package/templates/commands/capture-knowledge.md +7 -5
- package/templates/commands/check-implementation.md +7 -4
- package/templates/commands/code-review.md +7 -4
- package/templates/commands/debug.md +7 -4
- package/templates/commands/execute-plan.md +7 -4
- package/templates/commands/new-requirement.md +7 -6
- package/templates/commands/remember.md +6 -4
- package/templates/commands/review-design.md +13 -10
- package/templates/commands/review-requirements.md +11 -8
- package/templates/commands/simplify-implementation.md +6 -3
- package/templates/commands/update-planning.md +6 -3
- package/templates/commands/writing-test.md +8 -5
- package/dist/lib/AgentManager.d.ts +0 -104
- package/dist/lib/AgentManager.d.ts.map +0 -1
- package/dist/lib/AgentManager.js +0 -185
- package/dist/lib/AgentManager.js.map +0 -1
- package/dist/lib/TerminalFocusManager.d.ts +0 -22
- package/dist/lib/TerminalFocusManager.d.ts.map +0 -1
- package/dist/lib/TerminalFocusManager.js +0 -195
- package/dist/lib/TerminalFocusManager.js.map +0 -1
- package/dist/lib/adapters/AgentAdapter.d.ts +0 -92
- package/dist/lib/adapters/AgentAdapter.d.ts.map +0 -1
- package/dist/lib/adapters/AgentAdapter.js +0 -29
- package/dist/lib/adapters/AgentAdapter.js.map +0 -1
- package/dist/lib/adapters/ClaudeCodeAdapter.d.ts +0 -66
- package/dist/lib/adapters/ClaudeCodeAdapter.d.ts.map +0 -1
- package/dist/lib/adapters/ClaudeCodeAdapter.js +0 -306
- package/dist/lib/adapters/ClaudeCodeAdapter.js.map +0 -1
- package/dist/templates/env/base.md +0 -101
- package/dist/templates/templates/env/base.md +0 -101
- package/templates/env/base.md +0 -101
|
@@ -1,101 +0,0 @@
|
|
|
1
|
-
# AI DevKit Rules
|
|
2
|
-
|
|
3
|
-
## Project Context
|
|
4
|
-
This project uses ai-devkit for structured AI-assisted development. Phase documentation is located in `docs/ai/`.
|
|
5
|
-
|
|
6
|
-
## Documentation Structure
|
|
7
|
-
- `docs/ai/requirements/` - Problem understanding and requirements
|
|
8
|
-
- `docs/ai/design/` - System architecture and design decisions (include mermaid diagrams)
|
|
9
|
-
- `docs/ai/planning/` - Task breakdown and project planning
|
|
10
|
-
- `docs/ai/implementation/` - Implementation guides and notes
|
|
11
|
-
- `docs/ai/testing/` - Testing strategy and test cases
|
|
12
|
-
- `docs/ai/deployment/` - Deployment and infrastructure docs
|
|
13
|
-
- `docs/ai/monitoring/` - Monitoring and observability setup
|
|
14
|
-
|
|
15
|
-
## Code Style & Standards
|
|
16
|
-
- Follow the project's established code style and conventions
|
|
17
|
-
- Write clear, self-documenting code with meaningful variable names
|
|
18
|
-
- Add comments for complex logic or non-obvious decisions
|
|
19
|
-
|
|
20
|
-
## Development Workflow
|
|
21
|
-
- Review phase documentation in `docs/ai/` before implementing features
|
|
22
|
-
- Keep requirements, design, and implementation docs updated as the project evolves
|
|
23
|
-
- Reference the planning doc for task breakdown and priorities
|
|
24
|
-
- Copy the testing template (`docs/ai/testing/README.md`) before creating feature-specific testing docs
|
|
25
|
-
|
|
26
|
-
## AI Interaction Guidelines
|
|
27
|
-
- When implementing features, first check relevant phase documentation
|
|
28
|
-
- For new features, start with requirements clarification
|
|
29
|
-
- Update phase docs when significant changes or decisions are made
|
|
30
|
-
|
|
31
|
-
## Skills (Extend Your Capabilities)
|
|
32
|
-
Skills are packaged capabilities that teach you new competencies, patterns, and best practices. Check for installed skills in the project's skill directory and use them to enhance your work.
|
|
33
|
-
|
|
34
|
-
### Using Installed Skills
|
|
35
|
-
1. **Check for skills**: Look for `SKILL.md` files in the project's skill directory
|
|
36
|
-
2. **Read skill instructions**: Each skill contains detailed guidance on when and how to use it
|
|
37
|
-
3. **Apply skill knowledge**: Follow the patterns, commands, and best practices defined in the skill
|
|
38
|
-
|
|
39
|
-
### Key Installed Skills
|
|
40
|
-
- **memory**: Use AI DevKit's memory service via CLI commands when MCP is unavailable. Read the skill for detailed `memory store` and `memory search` command usage.
|
|
41
|
-
|
|
42
|
-
### When to Reference Skills
|
|
43
|
-
- Before implementing features that match a skill's domain
|
|
44
|
-
- When MCP tools are unavailable but skill provides CLI alternatives
|
|
45
|
-
- To follow established patterns and conventions defined in skills
|
|
46
|
-
|
|
47
|
-
## Knowledge Memory (Always Use When Helpful)
|
|
48
|
-
The AI assistant should proactively use knowledge memory throughout all interactions.
|
|
49
|
-
|
|
50
|
-
> **Tip**: If MCP is unavailable, use the **memory skill** for detailed CLI command reference.
|
|
51
|
-
|
|
52
|
-
### When to Search Memory
|
|
53
|
-
- Before starting any task, search for relevant project conventions, patterns, or decisions
|
|
54
|
-
- When you need clarification on how something was done before
|
|
55
|
-
- To check for existing solutions to similar problems
|
|
56
|
-
- To understand project-specific terminology or standards
|
|
57
|
-
|
|
58
|
-
**How to search**:
|
|
59
|
-
- Use `memory.searchKnowledge` MCP tool with relevant keywords, tags, and scope
|
|
60
|
-
- If MCP tools are unavailable, use `npx ai-devkit@latest memory search` CLI command (see memory skill for details)
|
|
61
|
-
- Example: Search for "authentication patterns" when implementing auth features
|
|
62
|
-
|
|
63
|
-
### When to Store Memory
|
|
64
|
-
- After making important architectural or design decisions
|
|
65
|
-
- When discovering useful patterns or solutions worth reusing
|
|
66
|
-
- If the user explicitly asks to "remember this" or save guidance
|
|
67
|
-
- When you establish new conventions or standards for the project
|
|
68
|
-
|
|
69
|
-
**How to store**:
|
|
70
|
-
- Use `memory.storeKnowledge` MCP tool
|
|
71
|
-
- If MCP tools are unavailable, use `npx ai-devkit@latest memory store` CLI command (see memory skill for details)
|
|
72
|
-
- Include clear title, detailed content, relevant tags, and appropriate scope
|
|
73
|
-
- Make knowledge specific and actionable, not generic advice
|
|
74
|
-
|
|
75
|
-
### Memory Best Practices
|
|
76
|
-
- **Be Proactive**: Search memory before asking the user repetitive questions
|
|
77
|
-
- **Be Specific**: Store knowledge that's actionable and reusable
|
|
78
|
-
- **Use Tags**: Tag knowledge appropriately for easy discovery (e.g., "api", "testing", "architecture")
|
|
79
|
-
- **Scope Appropriately**: Use `global` for general patterns, `project:<name>` for project-specific knowledge
|
|
80
|
-
|
|
81
|
-
## Testing & Quality
|
|
82
|
-
- Write tests alongside implementation
|
|
83
|
-
- Follow the testing strategy defined in `docs/ai/testing/`
|
|
84
|
-
- Use `/writing-test` to generate unit and integration tests targeting 100% coverage
|
|
85
|
-
- Ensure code passes all tests before considering it complete
|
|
86
|
-
|
|
87
|
-
## Documentation
|
|
88
|
-
- Update phase documentation when requirements or design changes
|
|
89
|
-
- Keep inline code comments focused and relevant
|
|
90
|
-
- Document architectural decisions and their rationale
|
|
91
|
-
- Use mermaid diagrams for any architectural or data-flow visuals (update existing diagrams if needed)
|
|
92
|
-
- Record test coverage results and outstanding gaps in `docs/ai/testing/`
|
|
93
|
-
|
|
94
|
-
## Key Commands
|
|
95
|
-
When working on this project, you can run commands to:
|
|
96
|
-
- Understand project requirements and goals (`review-requirements`)
|
|
97
|
-
- Review architectural decisions (`review-design`)
|
|
98
|
-
- Plan and execute tasks (`execute-plan`)
|
|
99
|
-
- Verify implementation against design (`check-implementation`)
|
|
100
|
-
- Writing tests (`writing-test`)
|
|
101
|
-
- Perform structured code reviews (`code-review`)
|
package/templates/env/base.md
DELETED
|
@@ -1,101 +0,0 @@
|
|
|
1
|
-
# AI DevKit Rules
|
|
2
|
-
|
|
3
|
-
## Project Context
|
|
4
|
-
This project uses ai-devkit for structured AI-assisted development. Phase documentation is located in `docs/ai/`.
|
|
5
|
-
|
|
6
|
-
## Documentation Structure
|
|
7
|
-
- `docs/ai/requirements/` - Problem understanding and requirements
|
|
8
|
-
- `docs/ai/design/` - System architecture and design decisions (include mermaid diagrams)
|
|
9
|
-
- `docs/ai/planning/` - Task breakdown and project planning
|
|
10
|
-
- `docs/ai/implementation/` - Implementation guides and notes
|
|
11
|
-
- `docs/ai/testing/` - Testing strategy and test cases
|
|
12
|
-
- `docs/ai/deployment/` - Deployment and infrastructure docs
|
|
13
|
-
- `docs/ai/monitoring/` - Monitoring and observability setup
|
|
14
|
-
|
|
15
|
-
## Code Style & Standards
|
|
16
|
-
- Follow the project's established code style and conventions
|
|
17
|
-
- Write clear, self-documenting code with meaningful variable names
|
|
18
|
-
- Add comments for complex logic or non-obvious decisions
|
|
19
|
-
|
|
20
|
-
## Development Workflow
|
|
21
|
-
- Review phase documentation in `docs/ai/` before implementing features
|
|
22
|
-
- Keep requirements, design, and implementation docs updated as the project evolves
|
|
23
|
-
- Reference the planning doc for task breakdown and priorities
|
|
24
|
-
- Copy the testing template (`docs/ai/testing/README.md`) before creating feature-specific testing docs
|
|
25
|
-
|
|
26
|
-
## AI Interaction Guidelines
|
|
27
|
-
- When implementing features, first check relevant phase documentation
|
|
28
|
-
- For new features, start with requirements clarification
|
|
29
|
-
- Update phase docs when significant changes or decisions are made
|
|
30
|
-
|
|
31
|
-
## Skills (Extend Your Capabilities)
|
|
32
|
-
Skills are packaged capabilities that teach you new competencies, patterns, and best practices. Check for installed skills in the project's skill directory and use them to enhance your work.
|
|
33
|
-
|
|
34
|
-
### Using Installed Skills
|
|
35
|
-
1. **Check for skills**: Look for `SKILL.md` files in the project's skill directory
|
|
36
|
-
2. **Read skill instructions**: Each skill contains detailed guidance on when and how to use it
|
|
37
|
-
3. **Apply skill knowledge**: Follow the patterns, commands, and best practices defined in the skill
|
|
38
|
-
|
|
39
|
-
### Key Installed Skills
|
|
40
|
-
- **memory**: Use AI DevKit's memory service via CLI commands when MCP is unavailable. Read the skill for detailed `memory store` and `memory search` command usage.
|
|
41
|
-
|
|
42
|
-
### When to Reference Skills
|
|
43
|
-
- Before implementing features that match a skill's domain
|
|
44
|
-
- When MCP tools are unavailable but skill provides CLI alternatives
|
|
45
|
-
- To follow established patterns and conventions defined in skills
|
|
46
|
-
|
|
47
|
-
## Knowledge Memory (Always Use When Helpful)
|
|
48
|
-
The AI assistant should proactively use knowledge memory throughout all interactions.
|
|
49
|
-
|
|
50
|
-
> **Tip**: If MCP is unavailable, use the **memory skill** for detailed CLI command reference.
|
|
51
|
-
|
|
52
|
-
### When to Search Memory
|
|
53
|
-
- Before starting any task, search for relevant project conventions, patterns, or decisions
|
|
54
|
-
- When you need clarification on how something was done before
|
|
55
|
-
- To check for existing solutions to similar problems
|
|
56
|
-
- To understand project-specific terminology or standards
|
|
57
|
-
|
|
58
|
-
**How to search**:
|
|
59
|
-
- Use `memory.searchKnowledge` MCP tool with relevant keywords, tags, and scope
|
|
60
|
-
- If MCP tools are unavailable, use `npx ai-devkit@latest memory search` CLI command (see memory skill for details)
|
|
61
|
-
- Example: Search for "authentication patterns" when implementing auth features
|
|
62
|
-
|
|
63
|
-
### When to Store Memory
|
|
64
|
-
- After making important architectural or design decisions
|
|
65
|
-
- When discovering useful patterns or solutions worth reusing
|
|
66
|
-
- If the user explicitly asks to "remember this" or save guidance
|
|
67
|
-
- When you establish new conventions or standards for the project
|
|
68
|
-
|
|
69
|
-
**How to store**:
|
|
70
|
-
- Use `memory.storeKnowledge` MCP tool
|
|
71
|
-
- If MCP tools are unavailable, use `npx ai-devkit@latest memory store` CLI command (see memory skill for details)
|
|
72
|
-
- Include clear title, detailed content, relevant tags, and appropriate scope
|
|
73
|
-
- Make knowledge specific and actionable, not generic advice
|
|
74
|
-
|
|
75
|
-
### Memory Best Practices
|
|
76
|
-
- **Be Proactive**: Search memory before asking the user repetitive questions
|
|
77
|
-
- **Be Specific**: Store knowledge that's actionable and reusable
|
|
78
|
-
- **Use Tags**: Tag knowledge appropriately for easy discovery (e.g., "api", "testing", "architecture")
|
|
79
|
-
- **Scope Appropriately**: Use `global` for general patterns, `project:<name>` for project-specific knowledge
|
|
80
|
-
|
|
81
|
-
## Testing & Quality
|
|
82
|
-
- Write tests alongside implementation
|
|
83
|
-
- Follow the testing strategy defined in `docs/ai/testing/`
|
|
84
|
-
- Use `/writing-test` to generate unit and integration tests targeting 100% coverage
|
|
85
|
-
- Ensure code passes all tests before considering it complete
|
|
86
|
-
|
|
87
|
-
## Documentation
|
|
88
|
-
- Update phase documentation when requirements or design changes
|
|
89
|
-
- Keep inline code comments focused and relevant
|
|
90
|
-
- Document architectural decisions and their rationale
|
|
91
|
-
- Use mermaid diagrams for any architectural or data-flow visuals (update existing diagrams if needed)
|
|
92
|
-
- Record test coverage results and outstanding gaps in `docs/ai/testing/`
|
|
93
|
-
|
|
94
|
-
## Key Commands
|
|
95
|
-
When working on this project, you can run commands to:
|
|
96
|
-
- Understand project requirements and goals (`review-requirements`)
|
|
97
|
-
- Review architectural decisions (`review-design`)
|
|
98
|
-
- Plan and execute tasks (`execute-plan`)
|
|
99
|
-
- Verify implementation against design (`check-implementation`)
|
|
100
|
-
- Writing tests (`writing-test`)
|
|
101
|
-
- Perform structured code reviews (`code-review`)
|