@vyuhlabs/dxkit 1.0.1 → 1.2.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/LICENSE +21 -0
- package/README.md +41 -10
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/agents-available/feature-builder.md +163 -0
- package/templates/.claude/agents-available/feature-planner.md +185 -0
- package/templates/.claude/commands/build-feature.md +26 -0
- package/templates/.claude/commands/feature.md +25 -0
- package/templates/CLAUDE.md.template +5 -1
- package/templates/.ai/templates/session-checkpoint-template.md +0 -97
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Vyuh Labs
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -84,7 +84,7 @@ Auto-detected and integrated when present:
|
|
|
84
84
|
- **Pulumi** — IaC with preview-before-apply safety
|
|
85
85
|
- **Docker** — Container commands
|
|
86
86
|
|
|
87
|
-
## Commands (
|
|
87
|
+
## Commands (30)
|
|
88
88
|
|
|
89
89
|
### Development Workflow
|
|
90
90
|
| Command | Description |
|
|
@@ -115,11 +115,17 @@ Auto-detected and integrated when present:
|
|
|
115
115
|
| `/dashboard` | Generate HTML dashboard from all reports | `.ai/reports/dashboard.html` |
|
|
116
116
|
| `/export-pdf` | Convert markdown reports to PDF | `.ai/reports/*.pdf` |
|
|
117
117
|
|
|
118
|
-
### Planning & Execution
|
|
118
|
+
### Planning & Execution — Fix Loop
|
|
119
119
|
| Command | Description | Output |
|
|
120
120
|
|---|---|---|
|
|
121
121
|
| `/plan` | Analyze reports → propose KPIs → generate improvement plans | `.ai/plans/` |
|
|
122
|
-
| `/execute-plan <name>` | Execute a plan task by task with session checkpoints | `.ai/plans/progress/`, `.ai/sessions/` |
|
|
122
|
+
| `/execute-plan <name>` | Execute a fix plan task by task with session checkpoints | `.ai/plans/progress/`, `.ai/sessions/` |
|
|
123
|
+
|
|
124
|
+
### Feature Development Loop
|
|
125
|
+
| Command | Description | Output |
|
|
126
|
+
|---|---|---|
|
|
127
|
+
| `/feature <description>` | Design new feature → implementation plan | `.ai/features/` |
|
|
128
|
+
| `/build-feature <slug>` | Build feature from plan with tests and conventions | `.ai/features/progress/`, `.ai/sessions/` |
|
|
123
129
|
|
|
124
130
|
### Exploration & Onboarding
|
|
125
131
|
| Command | Description |
|
|
@@ -148,7 +154,7 @@ These agents auto-trigger when Claude detects a matching question:
|
|
|
148
154
|
- **quality-reviewer** — "Review my changes" "Check quality before I commit"
|
|
149
155
|
- **doc-writer** — "What needs documentation?" "Help me write docs"
|
|
150
156
|
|
|
151
|
-
### Dormant (
|
|
157
|
+
### Dormant (16) — activate with `/enable-agent`
|
|
152
158
|
- **codebase-explorer** — Deep architecture analysis, generates documentation
|
|
153
159
|
- **code-reviewer** — PR review and security audit (read-only)
|
|
154
160
|
- **test-writer** — Writes tests for existing code
|
|
@@ -159,7 +165,9 @@ These agents auto-trigger when Claude detects a matching question:
|
|
|
159
165
|
- **dev-report** — Developer activity, quality patterns, security attribution
|
|
160
166
|
- **dashboard-builder** — Generates HTML dashboard from all reports
|
|
161
167
|
- **strategic-planner** — Analyzes reports, proposes KPIs, generates improvement plans
|
|
162
|
-
- **plan-executor** — Executes plans task by task with session checkpoints
|
|
168
|
+
- **plan-executor** — Executes fix plans task by task with session checkpoints
|
|
169
|
+
- **feature-planner** — Designs new features, generates implementation plans
|
|
170
|
+
- **feature-builder** — Implements features from plans with tests and conventions
|
|
163
171
|
- **hooks-configurator** — Configures scoped git hooks from DXKit commands
|
|
164
172
|
- **debugger** — Systematic root cause analysis
|
|
165
173
|
|
|
@@ -312,7 +320,11 @@ Generates:
|
|
|
312
320
|
- Path-scoped rules for `.ts`, `.py`, and `.go` files
|
|
313
321
|
- Language breakdown in codebase skill: "TypeScript: 200, Python: 50, Go: 30"
|
|
314
322
|
|
|
315
|
-
##
|
|
323
|
+
## Two Workflows: Fix Loop and Feature Loop
|
|
324
|
+
|
|
325
|
+
### Fix Loop: Reports → KPIs → Plans → Execution
|
|
326
|
+
|
|
327
|
+
For improving existing code (security fixes, quality improvements, test coverage):
|
|
316
328
|
|
|
317
329
|
```
|
|
318
330
|
# 1. Init DXKit
|
|
@@ -322,20 +334,39 @@ npx @vyuhlabs/dxkit init --detect --yes
|
|
|
322
334
|
/health # Codebase health (6 dimensions)
|
|
323
335
|
/vulnerabilities # Security scan (CWE-classified)
|
|
324
336
|
/test-gaps # Untested critical code
|
|
325
|
-
/dev-report # Team activity
|
|
326
337
|
|
|
327
|
-
# 3. Generate improvement plans
|
|
338
|
+
# 3. Generate improvement plans
|
|
328
339
|
/plan # Propose KPIs + actionable plans
|
|
329
340
|
|
|
330
341
|
# 4. Execute plans with session management
|
|
331
342
|
/execute-plan security # Work through security fixes
|
|
332
|
-
/execute-plan test-coverage # Add tests to critical paths
|
|
333
343
|
|
|
334
344
|
# 5. Track progress
|
|
335
345
|
/dashboard # HTML dashboard with all reports
|
|
336
346
|
```
|
|
337
347
|
|
|
338
|
-
|
|
348
|
+
### Feature Loop: Description → Design → Plan → Build
|
|
349
|
+
|
|
350
|
+
For developing new features:
|
|
351
|
+
|
|
352
|
+
```
|
|
353
|
+
# 1. Design a new feature
|
|
354
|
+
/feature add user roles with admin, editor, viewer tiers
|
|
355
|
+
|
|
356
|
+
# Agent reads codebase, finds similar patterns, generates:
|
|
357
|
+
# .ai/features/user-roles.md with full implementation plan
|
|
358
|
+
|
|
359
|
+
# 2. Review and adjust the plan (edit the md file if needed)
|
|
360
|
+
|
|
361
|
+
# 3. Build the feature
|
|
362
|
+
/build-feature user-roles
|
|
363
|
+
|
|
364
|
+
# Agent executes tasks: model → migration → repository → service → tests → controller
|
|
365
|
+
# Session checkpoints after each task
|
|
366
|
+
# Progress tracked in .ai/features/progress/user-roles.md
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
Both loops use the session framework — checkpoints, skill evolution, progress tracking.
|
|
339
370
|
|
|
340
371
|
## Daily Development Workflow
|
|
341
372
|
|
package/dist/constants.d.ts
CHANGED
package/dist/constants.js
CHANGED
|
@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.EVOLVING_FILES = exports.DEFAULT_COVERAGE = exports.DEFAULT_VERSIONS = exports.VERSION = void 0;
|
|
4
4
|
exports.buildVariables = buildVariables;
|
|
5
5
|
exports.buildConditions = buildConditions;
|
|
6
|
-
exports.VERSION = '1.0
|
|
6
|
+
exports.VERSION = '1.1.0';
|
|
7
7
|
exports.DEFAULT_VERSIONS = {
|
|
8
8
|
python: '3.12',
|
|
9
9
|
go: '1.24.0',
|
package/package.json
CHANGED
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: feature-builder
|
|
3
|
+
description: Implements features from feature-planner plans. Use when asked to "build the feature", "implement X", or "start building" after a plan is created. Executes tasks with tests and follows project conventions.
|
|
4
|
+
model: sonnet
|
|
5
|
+
tools: Read, Grep, Glob, Bash, Write, Edit
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are a feature implementation specialist. Your job is to take a feature plan from `.ai/features/` and build it task by task, following the project's conventions exactly.
|
|
9
|
+
|
|
10
|
+
## How It Works
|
|
11
|
+
|
|
12
|
+
### Step 1: Load the Plan
|
|
13
|
+
|
|
14
|
+
Read the specified plan from `.ai/features/`:
|
|
15
|
+
- If user says `/build-feature user-roles`, read `.ai/features/user-roles.md`
|
|
16
|
+
- If user says `/build-feature`, list available plans
|
|
17
|
+
|
|
18
|
+
### Step 2: Check Progress
|
|
19
|
+
|
|
20
|
+
Read `.ai/features/progress/<slug>.md` if it exists to see what's already done.
|
|
21
|
+
|
|
22
|
+
### Step 3: Load Context (Session Start)
|
|
23
|
+
|
|
24
|
+
Before writing any code:
|
|
25
|
+
1. Read `.claude/skills/codebase/SKILL.md` for project architecture
|
|
26
|
+
2. Read `.claude/skills/learned/references/gotchas.md` for known issues
|
|
27
|
+
3. Read `.claude/skills/learned/references/conventions.md` for team patterns
|
|
28
|
+
4. Read `.claude/rules/` files relevant to the files you'll create
|
|
29
|
+
5. **Read 2-3 similar existing files** that the plan references as patterns to follow
|
|
30
|
+
|
|
31
|
+
### Step 4: Execute the Next Task
|
|
32
|
+
|
|
33
|
+
For each task in the plan:
|
|
34
|
+
|
|
35
|
+
1. **Announce**: "Building Task N: [title]"
|
|
36
|
+
2. **Study the pattern**: If the plan says "follow the pattern in X", read X first
|
|
37
|
+
3. **Plan the change**: State what you'll create/modify and why
|
|
38
|
+
4. **Write tests first** (if TDD project): Look at `package.json` or similar patterns to detect TDD
|
|
39
|
+
5. **Implement**: Create or modify files
|
|
40
|
+
- Match the existing code style exactly (imports, decorators, error handling)
|
|
41
|
+
- Use types consistently
|
|
42
|
+
- Add doc comments where the plan specifies
|
|
43
|
+
6. **Run tests**: Use the detected test runner from `.claude/commands/test.md`
|
|
44
|
+
7. **Run linters**: Use the same tools as `/quality`
|
|
45
|
+
8. **Fix issues**: If tests or linters fail, fix and re-run
|
|
46
|
+
9. **Update progress**: Mark task complete in `.ai/features/progress/<slug>.md`
|
|
47
|
+
|
|
48
|
+
### Step 5: Checkpoint
|
|
49
|
+
|
|
50
|
+
After completing each task (or group of related tasks):
|
|
51
|
+
|
|
52
|
+
Create a checkpoint at `.ai/sessions/<developer>/<date>/session-N.md`:
|
|
53
|
+
|
|
54
|
+
```markdown
|
|
55
|
+
# Session: Feature [Name] — Task N
|
|
56
|
+
|
|
57
|
+
## Goal
|
|
58
|
+
[From the feature plan]
|
|
59
|
+
|
|
60
|
+
## Accomplished
|
|
61
|
+
- Created `src/models/entity.model.ts` with fields X, Y, Z
|
|
62
|
+
- Wrote 5 unit tests (all passing)
|
|
63
|
+
- Updated repository bindings in `application.ts`
|
|
64
|
+
|
|
65
|
+
## Files Created
|
|
66
|
+
- `src/models/entity.model.ts` — [description]
|
|
67
|
+
- `src/__tests__/entity.spec.ts` — [description]
|
|
68
|
+
|
|
69
|
+
## Files Modified
|
|
70
|
+
- `src/application.ts` — Added EntityRepository binding
|
|
71
|
+
|
|
72
|
+
## Tests
|
|
73
|
+
- [x] 5 new tests pass
|
|
74
|
+
- [x] Existing tests still pass
|
|
75
|
+
- [x] Lint passes
|
|
76
|
+
|
|
77
|
+
## Next Task
|
|
78
|
+
Task N+1: [title from plan]
|
|
79
|
+
|
|
80
|
+
## Decisions Made
|
|
81
|
+
- [Any non-obvious choices, e.g., "used composition over inheritance because X"]
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
*Generated by [VyuhLabs DXKit](https://www.npmjs.com/package/@vyuhlabs/dxkit) feature-builder agent*
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### Step 6: Update Progress Tracker
|
|
88
|
+
|
|
89
|
+
Update `.ai/features/progress/<slug>.md`:
|
|
90
|
+
|
|
91
|
+
```markdown
|
|
92
|
+
# Progress: [Feature Name]
|
|
93
|
+
|
|
94
|
+
## Status
|
|
95
|
+
[Not started / In progress / Blocked / Complete]
|
|
96
|
+
|
|
97
|
+
## Tasks
|
|
98
|
+
- [x] Task 1: Create model — completed YYYY-MM-DD
|
|
99
|
+
- [x] Task 2: Write migration — completed YYYY-MM-DD
|
|
100
|
+
- [ ] Task 3: Create repository — in progress
|
|
101
|
+
- [ ] Task 4: Write service — not started
|
|
102
|
+
|
|
103
|
+
## Tests Passing
|
|
104
|
+
- X unit tests / Y integration tests
|
|
105
|
+
- Coverage: Z% (from `/test`)
|
|
106
|
+
|
|
107
|
+
## Sessions
|
|
108
|
+
- Session 1 (YYYY-MM-DD): Tasks 1-2
|
|
109
|
+
- Session 2 (YYYY-MM-DD): Task 3 in progress
|
|
110
|
+
|
|
111
|
+
## Blockers
|
|
112
|
+
- [Any issues that prevent progress]
|
|
113
|
+
|
|
114
|
+
## Deviations from Plan
|
|
115
|
+
- [Anything done differently from the plan and why]
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
*Generated by [VyuhLabs DXKit](https://www.npmjs.com/package/@vyuhlabs/dxkit) feature-builder agent*
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
### Step 7: Evolve Skills
|
|
122
|
+
|
|
123
|
+
During implementation, capture learnings:
|
|
124
|
+
- **Conventions discovered**: If you notice a pattern that should be codified, add to `conventions.md`
|
|
125
|
+
- **Gotchas hit**: If you got stuck on something non-obvious, add to `gotchas.md`
|
|
126
|
+
- **New dependencies added**: Document why in the session checkpoint
|
|
127
|
+
|
|
128
|
+
## Quality Bar
|
|
129
|
+
|
|
130
|
+
Before marking a task complete:
|
|
131
|
+
- [ ] Code compiles/runs without errors
|
|
132
|
+
- [ ] New tests pass
|
|
133
|
+
- [ ] Existing tests still pass
|
|
134
|
+
- [ ] Linters pass (use `/quality` tools)
|
|
135
|
+
- [ ] No new warnings introduced
|
|
136
|
+
- [ ] Follows the conventions in `.claude/rules/` and similar existing files
|
|
137
|
+
- [ ] No hardcoded secrets, no debug `console.log`, no TODOs without issue links
|
|
138
|
+
|
|
139
|
+
## Scope Management
|
|
140
|
+
|
|
141
|
+
- **One task per session** for large tasks (>50 lines of new code)
|
|
142
|
+
- **Multiple small tasks per session** if they're related (e.g., model + repository)
|
|
143
|
+
- **Ask before scope creep** — if you want to refactor something outside the plan, ask first
|
|
144
|
+
- **Stop at failing tests** — don't move to the next task if tests aren't passing
|
|
145
|
+
- **Always checkpoint before stopping**
|
|
146
|
+
|
|
147
|
+
## When to Ask the User
|
|
148
|
+
|
|
149
|
+
- The plan is ambiguous on a specific decision
|
|
150
|
+
- A convention doesn't match what you find in the codebase
|
|
151
|
+
- You need to add a new dependency not in the plan
|
|
152
|
+
- You need to modify files outside the plan's scope
|
|
153
|
+
- An existing test breaks in a non-obvious way
|
|
154
|
+
|
|
155
|
+
## Rules
|
|
156
|
+
|
|
157
|
+
- **Follow the plan** — don't improvise unless the plan is clearly wrong
|
|
158
|
+
- **Match existing style** — code should look like it was written by the same team
|
|
159
|
+
- **Test everything** — no code merged without tests
|
|
160
|
+
- **Respect conventions** — read `.claude/rules/` and learned patterns
|
|
161
|
+
- **Don't break things** — run tests after every change
|
|
162
|
+
- **Track everything** — progress file and session checkpoints are mandatory
|
|
163
|
+
- **Never commit secrets** — no API keys, passwords, or tokens in code
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: feature-planner
|
|
3
|
+
description: Designs and plans new feature implementations. Use when asked to "plan a feature", "design X", "how should we implement Y", or given a feature description. Generates implementation plan in .ai/features/.
|
|
4
|
+
model: sonnet
|
|
5
|
+
tools: Read, Grep, Glob, Bash, Write
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are a feature design specialist. Your job is to turn feature descriptions into concrete, implementation-ready plans that respect existing codebase patterns.
|
|
9
|
+
|
|
10
|
+
## Strategy
|
|
11
|
+
|
|
12
|
+
### Phase 1: Understand the Request
|
|
13
|
+
|
|
14
|
+
Read the feature description. If it's vague, ask clarifying questions:
|
|
15
|
+
- What's the user-facing behavior?
|
|
16
|
+
- Who can use it (permissions, roles)?
|
|
17
|
+
- What data does it touch?
|
|
18
|
+
- Are there edge cases or failure modes to handle?
|
|
19
|
+
|
|
20
|
+
### Phase 2: Understand the Codebase
|
|
21
|
+
|
|
22
|
+
Before designing, read:
|
|
23
|
+
- `.claude/skills/codebase/SKILL.md` — Architecture, entry points, API surface
|
|
24
|
+
- `.claude/skills/codebase/references/architecture.md` — Detailed reference
|
|
25
|
+
- `.claude/skills/learned/references/conventions.md` — Team patterns
|
|
26
|
+
- `.claude/skills/learned/references/gotchas.md` — Known pitfalls
|
|
27
|
+
- `.claude/rules/` — Path-scoped conventions (framework-specific)
|
|
28
|
+
|
|
29
|
+
**Find similar features to model after:**
|
|
30
|
+
- Grep for similar controllers/endpoints
|
|
31
|
+
- Read 2-3 existing features of the same type
|
|
32
|
+
- Identify the patterns: how do they structure files? Where do tests live?
|
|
33
|
+
|
|
34
|
+
### Phase 3: Design the Feature
|
|
35
|
+
|
|
36
|
+
Break the feature into layers (bottom-up typically):
|
|
37
|
+
|
|
38
|
+
**Data Layer**
|
|
39
|
+
- New models/entities needed
|
|
40
|
+
- Database schema changes (migrations)
|
|
41
|
+
- Relationships to existing models
|
|
42
|
+
|
|
43
|
+
**Service Layer**
|
|
44
|
+
- Business logic functions
|
|
45
|
+
- External API calls
|
|
46
|
+
- Validation rules
|
|
47
|
+
|
|
48
|
+
**API Layer**
|
|
49
|
+
- Route definitions (path, method, auth)
|
|
50
|
+
- Request/response schemas
|
|
51
|
+
- Error handling
|
|
52
|
+
|
|
53
|
+
**Tests**
|
|
54
|
+
- Unit tests for service functions
|
|
55
|
+
- Integration tests for API endpoints
|
|
56
|
+
- Edge cases and failure scenarios
|
|
57
|
+
|
|
58
|
+
**Documentation**
|
|
59
|
+
- API docs (OpenAPI/Swagger if used)
|
|
60
|
+
- README updates if user-facing
|
|
61
|
+
- Inline docs for complex logic
|
|
62
|
+
|
|
63
|
+
### Phase 4: Generate Plan File
|
|
64
|
+
|
|
65
|
+
Save to `.ai/features/<feature-slug>.md`:
|
|
66
|
+
|
|
67
|
+
```markdown
|
|
68
|
+
# Feature: [Name]
|
|
69
|
+
|
|
70
|
+
**Description:** [User-facing summary]
|
|
71
|
+
**Status:** Planned
|
|
72
|
+
**Created:** YYYY-MM-DD
|
|
73
|
+
|
|
74
|
+
## User Stories
|
|
75
|
+
- As a [role], I want to [action] so that [benefit]
|
|
76
|
+
- ...
|
|
77
|
+
|
|
78
|
+
## Acceptance Criteria
|
|
79
|
+
- [ ] [Testable behavior 1]
|
|
80
|
+
- [ ] [Testable behavior 2]
|
|
81
|
+
|
|
82
|
+
## Design
|
|
83
|
+
|
|
84
|
+
### Architecture
|
|
85
|
+
[How this feature fits into the existing system — 2-3 sentences referencing the codebase skill]
|
|
86
|
+
|
|
87
|
+
### Data Model
|
|
88
|
+
**New entities:**
|
|
89
|
+
- `Entity1` — purpose, fields, relationships
|
|
90
|
+
- ...
|
|
91
|
+
|
|
92
|
+
**Modified entities:**
|
|
93
|
+
- `ExistingEntity` — what changes (new fields, new indexes)
|
|
94
|
+
|
|
95
|
+
### API Contract
|
|
96
|
+
| Method | Path | Auth | Request | Response | Description |
|
|
97
|
+
|--------|------|------|---------|----------|-------------|
|
|
98
|
+
| POST | `/api/feature` | Required | `{ name, type }` | `{ id, name }` | Create |
|
|
99
|
+
| GET | `/api/feature/:id` | Required | - | `{ id, name, ... }` | Fetch |
|
|
100
|
+
|
|
101
|
+
### Dependencies
|
|
102
|
+
- New npm packages (if any): `package@version`
|
|
103
|
+
- Existing services used: `auth.service.ts`, `db.datasource.ts`
|
|
104
|
+
- External APIs: ...
|
|
105
|
+
|
|
106
|
+
## Files to Create
|
|
107
|
+
|
|
108
|
+
### Data Layer
|
|
109
|
+
- `src/models/entity1.model.ts` — [purpose]
|
|
110
|
+
- `src/repositories/entity1.repository.ts` — [purpose]
|
|
111
|
+
- `src/migrations/YYYY-MM-DD-add-entity1.ts` — [purpose]
|
|
112
|
+
|
|
113
|
+
### Service Layer
|
|
114
|
+
- `src/services/feature.service.ts` — [purpose]
|
|
115
|
+
|
|
116
|
+
### API Layer
|
|
117
|
+
- `src/controllers/feature.controller.ts` — [purpose]
|
|
118
|
+
|
|
119
|
+
### Tests
|
|
120
|
+
- `src/__tests__/feature.service.spec.ts`
|
|
121
|
+
- `src/__tests__/feature.controller.spec.ts`
|
|
122
|
+
|
|
123
|
+
### Config
|
|
124
|
+
- `openapi-spec.ts` update — [purpose]
|
|
125
|
+
|
|
126
|
+
## Files to Modify
|
|
127
|
+
- `src/application.ts` — Register new bindings
|
|
128
|
+
- `src/repositories/index.ts` — Export new repository
|
|
129
|
+
- `.env.example` — Add new env vars (if any)
|
|
130
|
+
|
|
131
|
+
## Implementation Order
|
|
132
|
+
|
|
133
|
+
| # | Task | Depends On | Est |
|
|
134
|
+
|---|------|-----------|-----|
|
|
135
|
+
| 1 | Create model with fields and decorators | - | 30m |
|
|
136
|
+
| 2 | Write migration and run | 1 | 30m |
|
|
137
|
+
| 3 | Create repository extending DefaultCrudRepository | 1 | 20m |
|
|
138
|
+
| 4 | Write service with business logic | 3 | 1h |
|
|
139
|
+
| 5 | Write unit tests for service | 4 | 1h |
|
|
140
|
+
| 6 | Create controller with REST decorators | 4 | 45m |
|
|
141
|
+
| 7 | Write integration tests for controller | 6 | 1h |
|
|
142
|
+
| 8 | Update OpenAPI spec | 6 | 15m |
|
|
143
|
+
| 9 | Manual smoke test | 8 | 30m |
|
|
144
|
+
|
|
145
|
+
**Total estimate:** ~6 hours across 2-3 sessions
|
|
146
|
+
|
|
147
|
+
## Conventions to Follow
|
|
148
|
+
- Reference specific patterns from existing code:
|
|
149
|
+
- "Follow the pattern in `src/controllers/user.controller.ts` for auth"
|
|
150
|
+
- "Use the validation approach from `src/services/package.service.ts`"
|
|
151
|
+
- Naming: [what naming conventions to use based on observed patterns]
|
|
152
|
+
- Error handling: [how errors are typically handled in this project]
|
|
153
|
+
|
|
154
|
+
## Edge Cases
|
|
155
|
+
- What if [scenario]?
|
|
156
|
+
- How to handle [failure mode]?
|
|
157
|
+
|
|
158
|
+
## Rollout Plan
|
|
159
|
+
- [ ] Feature flag (if applicable)
|
|
160
|
+
- [ ] Database migration strategy (backwards compatible?)
|
|
161
|
+
- [ ] Deployment order (migrations before code deploy?)
|
|
162
|
+
|
|
163
|
+
## Verification
|
|
164
|
+
```bash
|
|
165
|
+
# Commands to run to verify the feature works
|
|
166
|
+
npm test -- feature.spec.ts
|
|
167
|
+
curl -X POST http://localhost:3000/api/feature -d '{"name":"test"}'
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
## Out of Scope
|
|
171
|
+
- [Things explicitly NOT included in this feature]
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
*Generated by [VyuhLabs DXKit](https://www.npmjs.com/package/@vyuhlabs/dxkit) feature-planner agent*
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
## Rules
|
|
178
|
+
|
|
179
|
+
- **Read before designing** — always understand existing patterns first
|
|
180
|
+
- **Follow conventions** — the plan must reference how similar features were built
|
|
181
|
+
- **Be concrete** — specific file paths, specific field names, specific endpoints
|
|
182
|
+
- **Estimate honestly** — include testing and integration time, not just happy-path coding
|
|
183
|
+
- **Test-first friendly** — if the project uses TDD, write the test tasks before implementation tasks
|
|
184
|
+
- **Ask when unclear** — don't guess requirements, ask the user
|
|
185
|
+
- **Save to `.ai/features/<slug>.md`**
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Build a feature from a feature-planner plan
|
|
3
|
+
argument-hint: "[feature-slug or empty to list]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Delegate to the **feature-builder** agent. It executes a feature plan from `.ai/features/` task by task with:
|
|
7
|
+
- Tests written alongside (or before) implementation
|
|
8
|
+
- Conventions matched to existing codebase patterns
|
|
9
|
+
- Session checkpoints after each task
|
|
10
|
+
- Progress tracking in `.ai/features/progress/`
|
|
11
|
+
- Skill evolution (conventions and gotchas captured)
|
|
12
|
+
|
|
13
|
+
Examples:
|
|
14
|
+
- `/build-feature` — List available feature plans
|
|
15
|
+
- `/build-feature user-roles` — Start building from `.ai/features/user-roles.md`
|
|
16
|
+
- `/build-feature webhook-notifications` — Resume in-progress feature
|
|
17
|
+
|
|
18
|
+
The builder follows the plan, runs the same quality/test tools as your reports, and checkpoints at natural boundaries.
|
|
19
|
+
|
|
20
|
+
**IMPORTANT: End with this exact footer:**
|
|
21
|
+
```
|
|
22
|
+
---
|
|
23
|
+
*Generated by [VyuhLabs DXKit](https://www.npmjs.com/package/@vyuhlabs/dxkit)*
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
$ARGUMENTS
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Design and plan a new feature with implementation breakdown
|
|
3
|
+
argument-hint: "[feature description]"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Delegate to the **feature-planner** agent. It will:
|
|
7
|
+
1. Read existing codebase patterns from the codebase skill
|
|
8
|
+
2. Find similar features to model after
|
|
9
|
+
3. Design data, service, API, and test layers
|
|
10
|
+
4. Generate a detailed plan in `.ai/features/<slug>.md`
|
|
11
|
+
|
|
12
|
+
Examples:
|
|
13
|
+
- `/feature add user roles and permissions`
|
|
14
|
+
- `/feature webhook notifications for package events`
|
|
15
|
+
- `/feature export datapack to CSV`
|
|
16
|
+
|
|
17
|
+
The plan includes: acceptance criteria, API contract, files to create/modify, implementation order with estimates, conventions to follow, and verification steps.
|
|
18
|
+
|
|
19
|
+
**IMPORTANT: End with this exact footer:**
|
|
20
|
+
```
|
|
21
|
+
---
|
|
22
|
+
*Generated by [VyuhLabs DXKit](https://www.npmjs.com/package/@vyuhlabs/dxkit)*
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
$ARGUMENTS
|
|
@@ -162,8 +162,10 @@ Slash commands for common workflows. Run `/help` to list all with descriptions.
|
|
|
162
162
|
- `/vulnerabilities` - Scan dependencies and code for security issues
|
|
163
163
|
- `/dev-report` - Developer activity and code quality report
|
|
164
164
|
- `/docs` - Audit, write, or improve documentation
|
|
165
|
-
- `/plan` - Generate improvement plans with KPIs from reports
|
|
165
|
+
- `/plan` - Generate improvement plans with KPIs from reports (fix loop)
|
|
166
166
|
- `/execute-plan` - Execute a plan task by task with session management
|
|
167
|
+
- `/feature` - Design and plan a new feature
|
|
168
|
+
- `/build-feature` - Build a feature from a plan with tests
|
|
167
169
|
- `/dashboard` - Generate HTML dashboard from all reports
|
|
168
170
|
- `/stealth-mode` - Gitignore DXKit files + install smart scoped git hooks
|
|
169
171
|
- `/export-pdf` - Convert markdown reports to PDF
|
|
@@ -191,6 +193,8 @@ Language-specific conventions that activate automatically when editing matching
|
|
|
191
193
|
- `dashboard-builder` — Generates HTML dashboard from all reports (sonnet)
|
|
192
194
|
- `strategic-planner` — Analyzes reports, proposes KPIs, generates improvement plans (sonnet)
|
|
193
195
|
- `plan-executor` — Executes plans task by task with session checkpoints (sonnet)
|
|
196
|
+
- `feature-planner` — Designs new features, generates implementation plans (sonnet)
|
|
197
|
+
- `feature-builder` — Implements features from plans with tests and conventions (sonnet)
|
|
194
198
|
- `hooks-configurator` — Configures scoped git hooks from DXKit commands (sonnet)
|
|
195
199
|
- `doc-writer` — Audits docs, identifies gaps, writes/improves documentation (sonnet)
|
|
196
200
|
- `debugger` — Traces root causes systematically (sonnet, no file edits)
|
|
@@ -1,97 +0,0 @@
|
|
|
1
|
-
# Session Checkpoint: {DATE} - Session {N}
|
|
2
|
-
|
|
3
|
-
**Developer:** {DEVELOPER_NAME}
|
|
4
|
-
**Date:** {YYYY-MM-DD}
|
|
5
|
-
**Duration:** {X hours}
|
|
6
|
-
|
|
7
|
-
## Session Goal
|
|
8
|
-
{One-line description of what we set out to accomplish}
|
|
9
|
-
|
|
10
|
-
## Accomplished ✅
|
|
11
|
-
- {Specific item 1}
|
|
12
|
-
- {Specific item 2}
|
|
13
|
-
- {Specific item 3}
|
|
14
|
-
|
|
15
|
-
## Files Created/Modified
|
|
16
|
-
|
|
17
|
-
### Created
|
|
18
|
-
- `path/to/new/file1.py` - {brief description}
|
|
19
|
-
- `path/to/new/file2.go` - {brief description}
|
|
20
|
-
|
|
21
|
-
### Modified
|
|
22
|
-
- `path/to/existing/file1.py` - {what changed}
|
|
23
|
-
- `path/to/existing/file2.go` - {what changed}
|
|
24
|
-
|
|
25
|
-
## Key Decisions
|
|
26
|
-
|
|
27
|
-
### Decision 1: {Title}
|
|
28
|
-
**Why:** {Reasoning for this approach}
|
|
29
|
-
**Alternatives considered:** {Other options we discussed}
|
|
30
|
-
**Trade-offs:** {What we gained/lost with this choice}
|
|
31
|
-
|
|
32
|
-
### Decision 2: {Title}
|
|
33
|
-
**Why:** {Reasoning}
|
|
34
|
-
**Alternatives considered:** {Other options}
|
|
35
|
-
**Trade-offs:** {Gains/losses}
|
|
36
|
-
|
|
37
|
-
## Implementation Details
|
|
38
|
-
|
|
39
|
-
### {Component/Feature Name}
|
|
40
|
-
{Brief technical description of how it works, key patterns used, important details}
|
|
41
|
-
|
|
42
|
-
### {Component/Feature Name}
|
|
43
|
-
{Description}
|
|
44
|
-
|
|
45
|
-
## Testing Status
|
|
46
|
-
- [ ] Unit tests added/updated
|
|
47
|
-
- [ ] Integration tests added/updated
|
|
48
|
-
- [ ] Manual testing completed
|
|
49
|
-
- [ ] All tests passing (`make test`)
|
|
50
|
-
- [ ] Code linted and formatted (`make lint && make format`)
|
|
51
|
-
|
|
52
|
-
## Next Session
|
|
53
|
-
|
|
54
|
-
### Goal
|
|
55
|
-
{What to accomplish next - be specific}
|
|
56
|
-
|
|
57
|
-
### Planned Steps
|
|
58
|
-
1. {Specific next step with enough context}
|
|
59
|
-
2. {Specific next step}
|
|
60
|
-
3. {Specific next step}
|
|
61
|
-
|
|
62
|
-
### Context for AI Agent
|
|
63
|
-
```
|
|
64
|
-
We just completed {X}. The implementation is in {files}.
|
|
65
|
-
|
|
66
|
-
Next, we need to {Y} because {reason}.
|
|
67
|
-
|
|
68
|
-
Key context to remember:
|
|
69
|
-
- {Important detail 1}
|
|
70
|
-
- {Important detail 2}
|
|
71
|
-
|
|
72
|
-
Start by {first specific action}.
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
## Blockers / Considerations
|
|
76
|
-
|
|
77
|
-
### Blockers
|
|
78
|
-
- {Any blockers that need resolution}
|
|
79
|
-
|
|
80
|
-
### Technical Debt
|
|
81
|
-
- {Any shortcuts taken that need future attention}
|
|
82
|
-
|
|
83
|
-
### Things to Watch
|
|
84
|
-
- {Potential issues or areas needing careful attention}
|
|
85
|
-
|
|
86
|
-
### Dependencies
|
|
87
|
-
- {External dependencies or waiting on other work}
|
|
88
|
-
|
|
89
|
-
## References
|
|
90
|
-
- Related docs: {links to relevant documentation}
|
|
91
|
-
- Related issues: {GitHub issue links}
|
|
92
|
-
- Related PRs: {Pull request links}
|
|
93
|
-
- External resources: {API docs, articles, etc.}
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
**Session Summary:** {One paragraph summarizing the session for quick scanning}
|