ateschh-kit 1.0.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/.claude/rules/01-identity.md +32 -0
- package/.claude/rules/02-language.md +21 -0
- package/.claude/rules/03-quality.md +39 -0
- package/.claude/rules/04-completion-lock.md +38 -0
- package/.claude/rules/05-state-management.md +48 -0
- package/.claude/rules/06-requirements-lock.md +69 -0
- package/.claude/rules/07-token-management.md +56 -0
- package/.claude/settings.local.json +13 -0
- package/ARCHITECTURE.md +222 -0
- package/CHANGELOG.md +74 -0
- package/CLAUDE.md +154 -0
- package/CONTRIBUTING.md +53 -0
- package/LICENSE +21 -0
- package/README.md +145 -0
- package/README.tr.md +145 -0
- package/agents/_TEMPLATE.md +59 -0
- package/agents/architect.md +117 -0
- package/agents/coder.md +90 -0
- package/agents/debugger.md +96 -0
- package/agents/deployer.md +123 -0
- package/agents/designer.md +154 -0
- package/agents/idea-analyst.md +92 -0
- package/agents/market-researcher.md +88 -0
- package/agents/requirements-expert.md +80 -0
- package/agents/tester.md +102 -0
- package/bin/install.js +142 -0
- package/package.json +46 -0
- package/skills/architecture-design/SKILL.md +92 -0
- package/skills/context-management/SKILL.md +92 -0
- package/skills/fix-bugs/SKILL.md +67 -0
- package/skills/idea-analysis/SKILL.md +71 -0
- package/skills/market-research/SKILL.md +70 -0
- package/skills/publish/SKILL.md +80 -0
- package/skills/requirements-lock/SKILL.md +75 -0
- package/skills/run-tests/SKILL.md +70 -0
- package/skills/write-code/SKILL.md +92 -0
- package/templates/project/DECISIONS.md +24 -0
- package/templates/project/DESIGN.md +141 -0
- package/templates/project/PLAN.md +63 -0
- package/templates/project/REQUIREMENTS.md +46 -0
- package/templates/project/STATE.md +94 -0
- package/templates/project/STRUCTURE.md +89 -0
- package/workflows/_TEMPLATE.md +44 -0
- package/workflows/brainstorm.md +69 -0
- package/workflows/build.md +92 -0
- package/workflows/deploy.md +85 -0
- package/workflows/design.md +84 -0
- package/workflows/finish.md +90 -0
- package/workflows/map-codebase.md +136 -0
- package/workflows/new-project.md +96 -0
- package/workflows/next.md +79 -0
- package/workflows/quick.md +82 -0
- package/workflows/requirements.md +85 -0
- package/workflows/resume.md +55 -0
- package/workflows/save.md +111 -0
- package/workflows/settings.md +92 -0
- package/workflows/status.md +67 -0
- package/workflows/test.md +105 -0
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
---
|
|
2
|
+
command: "/settings"
|
|
3
|
+
description: "View and edit your ateschh-kit configuration."
|
|
4
|
+
phase: "any"
|
|
5
|
+
agents: []
|
|
6
|
+
skills: []
|
|
7
|
+
outputs: [".state/USER-CONFIG.md"]
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# /settings — View & Edit Configuration
|
|
11
|
+
|
|
12
|
+
## Steps
|
|
13
|
+
|
|
14
|
+
### Step 1: Read Config
|
|
15
|
+
|
|
16
|
+
Read `.state/USER-CONFIG.md`:
|
|
17
|
+
- If it exists → display current settings
|
|
18
|
+
- If it doesn't exist → run first-time setup
|
|
19
|
+
|
|
20
|
+
### Step 2: Display Settings
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
⚙️ ateschh-kit Settings
|
|
24
|
+
|
|
25
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
26
|
+
Kit Version: 1.0.0
|
|
27
|
+
Config File: .state/USER-CONFIG.md
|
|
28
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
29
|
+
|
|
30
|
+
What would you like to change?
|
|
31
|
+
1. View all settings
|
|
32
|
+
2. Set active project
|
|
33
|
+
3. Reset all state
|
|
34
|
+
4. View system info
|
|
35
|
+
5. Cancel
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### Option 1: View All Settings
|
|
39
|
+
|
|
40
|
+
Display contents of `.state/USER-CONFIG.md` in formatted output.
|
|
41
|
+
|
|
42
|
+
### Option 2: Set Active Project
|
|
43
|
+
|
|
44
|
+
List all projects in `projects/` folder.
|
|
45
|
+
Ask: "Which project should be active?"
|
|
46
|
+
Update `.state/ACTIVE-PROJECT.md`.
|
|
47
|
+
|
|
48
|
+
### Option 3: Reset All State
|
|
49
|
+
|
|
50
|
+
⚠️ Warning dialog:
|
|
51
|
+
```
|
|
52
|
+
WARNING: This will clear:
|
|
53
|
+
- Active project reference
|
|
54
|
+
- Session log
|
|
55
|
+
- Active context
|
|
56
|
+
|
|
57
|
+
It will NOT delete your projects/ or archive/ folders.
|
|
58
|
+
|
|
59
|
+
Type "RESET" to confirm.
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
If confirmed:
|
|
63
|
+
- Clear `.state/ACTIVE-PROJECT.md`
|
|
64
|
+
- Clear `.state/ACTIVE_CONTEXT.md`
|
|
65
|
+
- Leave `SESSION-LOG.md` intact (historical record)
|
|
66
|
+
|
|
67
|
+
### Option 4: View System Info
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
System Info:
|
|
71
|
+
- OS: {detected OS}
|
|
72
|
+
- Kit location: {current directory}
|
|
73
|
+
- Projects: {count} active, {count} archived
|
|
74
|
+
- Total sessions: {count from SESSION-LOG.md}
|
|
75
|
+
- Context7 MCP: {connected / not connected}
|
|
76
|
+
- Other MCPs: {list}
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## USER-CONFIG.md Format
|
|
80
|
+
|
|
81
|
+
```markdown
|
|
82
|
+
# User Configuration
|
|
83
|
+
|
|
84
|
+
**Created**: {date}
|
|
85
|
+
**Version**: 1.0.0
|
|
86
|
+
|
|
87
|
+
## Preferences
|
|
88
|
+
|
|
89
|
+
(No preferences configured yet — defaults are used)
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Users can manually edit this file to add custom preferences that agents will respect.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
command: "/status"
|
|
3
|
+
description: "Shows current project progress and what comes next."
|
|
4
|
+
phase: "any"
|
|
5
|
+
agents: []
|
|
6
|
+
skills: []
|
|
7
|
+
outputs: ["Progress report"]
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# /status — Progress Report
|
|
11
|
+
|
|
12
|
+
## When to Use
|
|
13
|
+
|
|
14
|
+
Any time you want to see where the project stands.
|
|
15
|
+
|
|
16
|
+
## Steps
|
|
17
|
+
|
|
18
|
+
### Step 1: Read Files
|
|
19
|
+
|
|
20
|
+
Read:
|
|
21
|
+
- `.state/ACTIVE-PROJECT.md`
|
|
22
|
+
- `projects/{name}/STATE.md`
|
|
23
|
+
- `projects/{name}/PLAN.md`
|
|
24
|
+
|
|
25
|
+
### Step 2: Calculate Progress
|
|
26
|
+
|
|
27
|
+
Count tasks in PLAN.md:
|
|
28
|
+
- Total tasks
|
|
29
|
+
- Completed tasks (checked)
|
|
30
|
+
- Remaining tasks
|
|
31
|
+
|
|
32
|
+
Calculate: `{done}/{total} tasks complete ({percent}%)`
|
|
33
|
+
|
|
34
|
+
### Step 3: Generate Report
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
## Project Status — {name}
|
|
38
|
+
📅 Last active: {date}
|
|
39
|
+
|
|
40
|
+
### Phase Progress
|
|
41
|
+
Phase 1 — Idea & Research: ✅ Complete
|
|
42
|
+
Phase 2 — Requirements: ✅ Complete
|
|
43
|
+
Phase 3 — Design: ✅ Complete
|
|
44
|
+
Phase 4 — Build: 🔄 In Progress (6/12 tasks)
|
|
45
|
+
Phase 5 — Test: ⬜ Not started
|
|
46
|
+
Phase 6 — Deploy: ⬜ Not started
|
|
47
|
+
|
|
48
|
+
### Current Task
|
|
49
|
+
➡️ {current task name}
|
|
50
|
+
|
|
51
|
+
### Completed Today
|
|
52
|
+
- {task 1}
|
|
53
|
+
- {task 2}
|
|
54
|
+
|
|
55
|
+
### Remaining in Phase 4
|
|
56
|
+
- {task list}
|
|
57
|
+
|
|
58
|
+
### Backlog
|
|
59
|
+
{N} items in BACKLOG.md
|
|
60
|
+
|
|
61
|
+
### Next Command
|
|
62
|
+
Run `/build` to continue with: "{next task}"
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Step 4: Ask
|
|
66
|
+
|
|
67
|
+
"Want to continue? Run `/build` or `/next` to keep going."
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
---
|
|
2
|
+
command: "/test"
|
|
3
|
+
description: "Runs L3+L4 testing across the full app. Fixes bugs before deploy."
|
|
4
|
+
phase: "5"
|
|
5
|
+
agents: ["tester", "debugger"]
|
|
6
|
+
skills: ["run-tests", "fix-bugs"]
|
|
7
|
+
outputs: ["Test report", "Fixed bugs", "Updated STATE.md"]
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# /test — Test & Fix
|
|
11
|
+
|
|
12
|
+
## When to Use
|
|
13
|
+
|
|
14
|
+
When all tasks in PLAN.md are complete and you're preparing for deployment.
|
|
15
|
+
|
|
16
|
+
## Steps
|
|
17
|
+
|
|
18
|
+
### Step 1: Verify Phase
|
|
19
|
+
|
|
20
|
+
Read `projects/{name}/STATE.md`. Confirm all Phase 4 tasks are checked off.
|
|
21
|
+
|
|
22
|
+
### Step 2: Spawn Tester Agent
|
|
23
|
+
|
|
24
|
+
Read `agents/tester.md` and spawn the agent.
|
|
25
|
+
|
|
26
|
+
The tester runs the full 4-level suite:
|
|
27
|
+
|
|
28
|
+
#### L1 — Syntax
|
|
29
|
+
- [ ] `npm run build` exits cleanly
|
|
30
|
+
- [ ] Zero TypeScript errors
|
|
31
|
+
- [ ] Zero ESLint errors
|
|
32
|
+
|
|
33
|
+
#### L2 — Functionality (per feature)
|
|
34
|
+
- [ ] Each feature in STRUCTURE.md works as described
|
|
35
|
+
- [ ] No broken imports or missing components
|
|
36
|
+
|
|
37
|
+
#### L3 — Integration
|
|
38
|
+
- [ ] Navigation between pages works
|
|
39
|
+
- [ ] Data flows correctly (form → database → UI)
|
|
40
|
+
- [ ] Auth gates protect the right routes
|
|
41
|
+
- [ ] API responses handled (success + error states)
|
|
42
|
+
|
|
43
|
+
#### L4 — Quality
|
|
44
|
+
- [ ] Mobile responsive (if web)
|
|
45
|
+
- [ ] Loading states present
|
|
46
|
+
- [ ] No console.log left in production code
|
|
47
|
+
- [ ] Environment variables properly set
|
|
48
|
+
- [ ] No hardcoded credentials
|
|
49
|
+
|
|
50
|
+
### Step 3: Process Failures
|
|
51
|
+
|
|
52
|
+
For each failure found:
|
|
53
|
+
|
|
54
|
+
1. Log it: `[L{N}] {what broke} — {file:line}`
|
|
55
|
+
2. Spawn `debugger` agent with the failure details
|
|
56
|
+
3. Apply fix
|
|
57
|
+
4. Re-verify that specific check
|
|
58
|
+
|
|
59
|
+
### Step 4: Generate Test Report
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
## Test Report — {date}
|
|
63
|
+
|
|
64
|
+
| Level | Total | Passed | Failed |
|
|
65
|
+
|-------|-------|--------|--------|
|
|
66
|
+
| L1 | N | N | N |
|
|
67
|
+
| L2 | N | N | N |
|
|
68
|
+
| L3 | N | N | N |
|
|
69
|
+
| L4 | N | N | N |
|
|
70
|
+
|
|
71
|
+
### Issues Fixed
|
|
72
|
+
- {issue}: {fix applied}
|
|
73
|
+
|
|
74
|
+
### Remaining Issues (if any)
|
|
75
|
+
- {issue}: {reason not fixed / plan}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Step 5: Update STATE.md
|
|
79
|
+
|
|
80
|
+
Mark Phase 5 complete if all blocking issues are resolved.
|
|
81
|
+
|
|
82
|
+
### Step 6: Confirm to User
|
|
83
|
+
|
|
84
|
+
```
|
|
85
|
+
✅ Testing complete!
|
|
86
|
+
|
|
87
|
+
L1–L4 all passing.
|
|
88
|
+
{N} issues found and fixed.
|
|
89
|
+
|
|
90
|
+
Ready to deploy: run `/deploy`
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Or if issues remain:
|
|
94
|
+
```
|
|
95
|
+
⚠️ Testing complete with {N} unresolved issues.
|
|
96
|
+
|
|
97
|
+
These won't block deployment but should be addressed soon:
|
|
98
|
+
- {issue list}
|
|
99
|
+
|
|
100
|
+
Run `/deploy` when you're ready.
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## Next Step
|
|
104
|
+
|
|
105
|
+
`/deploy`
|