create-vasvibe 2.4.0 → 2.5.1
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 +170 -167
- package/bin/cli.mjs +9 -9
- package/package.json +45 -45
- package/src/git.mjs +47 -47
- package/src/index.mjs +228 -228
- package/src/prompts.mjs +113 -113
- package/src/scaffold.mjs +74 -74
- package/src/upgrade.mjs +121 -121
- package/src/utils.mjs +91 -91
- package/template/.agents/agents/analyst/agent.json +43 -43
- package/template/.agents/agents/backend/agent.json +44 -44
- package/template/.agents/agents/data-architect/agent.json +43 -43
- package/template/.agents/agents/devops/agent.json +44 -44
- package/template/.agents/agents/discovery/agent.json +43 -43
- package/template/.agents/agents/document/agent.json +43 -43
- package/template/.agents/agents/explorer/agent.json +43 -43
- package/template/.agents/agents/fixer/agent.json +44 -44
- package/template/.agents/agents/frontend/agent.json +44 -44
- package/template/.agents/agents/fullstack/agent.json +44 -44
- package/template/.agents/agents/initiator/agent.json +41 -41
- package/template/.agents/agents/logger/agent.json +43 -43
- package/template/.agents/agents/manual-tester/agent.json +44 -0
- package/template/.agents/agents/orchestrator/agent.json +44 -44
- package/template/.agents/agents/pm/agent.json +42 -42
- package/template/.agents/agents/qa/agent.json +44 -44
- package/template/.agents/agents/reliability/agent.json +44 -44
- package/template/.agents/agents/security/agent.json +44 -44
- package/template/.agents/agents/sysarch/agent.json +44 -44
- package/template/.agents/agents/tester/agent.json +44 -44
- package/template/.agents/agents/toolsmith/agent.json +44 -44
- package/template/.agents/agents/ux-designer/agent.json +43 -43
- package/template/.agents/skills/find-skills/SKILL.md +142 -142
- package/template/.agents/skills/fullstack/SKILL.md +89 -89
- package/template/.agents/skills/penetration-testing/SKILL.md +94 -94
- package/template/.agents/skills/penetration-testing/references/automated-penetration-testing-framework.md +328 -328
- package/template/.agents/skills/penetration-testing/references/burp-suite-automation-script.md +135 -135
- package/template/.agents/skills/penetration-testing/scripts/security-checklist.sh +30 -30
- package/template/.agents/skills/pm/SKILL.md +170 -170
- package/template/.agents/skills/ui-ux-pro-max/SKILL.md +658 -658
- package/template/.agents/skills/ui-ux-pro-max/data/_sync_all.py +414 -414
- package/template/.agents/skills/ui-ux-pro-max/data/app-interface.csv +30 -30
- package/template/.agents/skills/ui-ux-pro-max/data/design.csv +1775 -1775
- package/template/.agents/skills/ui-ux-pro-max/data/draft.csv +1778 -1778
- package/template/.agents/skills/ui-ux-pro-max/data/icons.csv +105 -105
- package/template/.agents/skills/ui-ux-pro-max/data/products.csv +162 -162
- package/template/.agents/skills/ui-ux-pro-max/data/react-performance.csv +45 -45
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/angular.csv +51 -51
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -54
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/laravel.csv +51 -51
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/react.csv +54 -54
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/threejs.csv +54 -54
- package/template/.agents/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -50
- package/template/.agents/skills/ui-ux-pro-max/data/typography.csv +74 -74
- package/template/.agents/skills/ui-ux-pro-max/scripts/core.py +262 -262
- package/template/.agents/skills/ui-ux-pro-max/scripts/design_system.py +1148 -1148
- package/template/.agents/workflows/build-feature.md +21 -21
- package/template/.agents/workflows/build-prototype.md +32 -32
- package/template/.agents/workflows/daily-standup.md +16 -16
- package/template/.agents/workflows/deliver-feature.md +16 -16
- package/template/.agents/workflows/explorer.md +78 -78
- package/template/.agents/workflows/harden-release.md +21 -21
- package/template/.agents/workflows/logger.md +117 -117
- package/template/.agents/workflows/plan-feature.md +30 -30
- package/template/.agents/workflows/plan-project.md +25 -25
- package/template/.agents/workflows/release.md +18 -18
- package/template/.agents/workflows/security-audit.md +19 -19
- package/template/.agents/workflows/setup-workspace.md +21 -21
- package/template/.agents/workflows/start-fix.md +18 -18
- package/template/.agents/workflows/test-feature.md +17 -17
- package/template/.claude/agents/analyst.md +109 -109
- package/template/.claude/agents/backend.md +61 -61
- package/template/.claude/agents/data-architect.md +43 -43
- package/template/.claude/agents/devops.md +44 -43
- package/template/.claude/agents/discovery.md +51 -51
- package/template/.claude/agents/document.md +51 -51
- package/template/.claude/agents/explorer.md +138 -138
- package/template/.claude/agents/fixer.md +87 -86
- package/template/.claude/agents/frontend.md +65 -65
- package/template/.claude/agents/fullstack.md +91 -90
- package/template/.claude/agents/initiator.md +74 -74
- package/template/.claude/agents/logger.md +143 -143
- package/template/.claude/agents/manual-tester.md +108 -0
- package/template/.claude/agents/orchestrator.md +138 -137
- package/template/.claude/agents/pm.md +199 -199
- package/template/.claude/agents/qa.md +66 -65
- package/template/.claude/agents/reliability.md +48 -47
- package/template/.claude/agents/security.md +107 -106
- package/template/.claude/agents/sysarch.md +301 -301
- package/template/.claude/agents/tester.md +100 -100
- package/template/.claude/agents/toolsmith.md +77 -76
- package/template/.claude/agents/ux-designer.md +45 -45
- package/template/.claude/commands/build-feature.md +22 -22
- package/template/.claude/commands/build-prototype.md +33 -33
- package/template/.claude/commands/daily-standup.md +16 -16
- package/template/.claude/commands/deliver-feature.md +17 -17
- package/template/.claude/commands/harden-release.md +22 -22
- package/template/.claude/commands/manual-test.md +19 -0
- package/template/.claude/commands/plan-feature.md +31 -31
- package/template/.claude/commands/plan-project.md +26 -26
- package/template/.claude/commands/release.md +19 -19
- package/template/.claude/commands/security-audit.md +20 -20
- package/template/.claude/commands/setup-workspace.md +22 -22
- package/template/.claude/commands/start-fix.md +19 -19
- package/template/.claude/commands/test-feature.md +18 -18
- package/template/.claude/skills/find-skills/SKILL.md +142 -142
- package/template/.claude/skills/penetration-testing/SKILL.md +94 -94
- package/template/.claude/skills/penetration-testing/references/automated-penetration-testing-framework.md +328 -328
- package/template/.claude/skills/penetration-testing/references/burp-suite-automation-script.md +135 -135
- package/template/.claude/skills/penetration-testing/scripts/security-checklist.sh +30 -30
- package/template/.claude/skills/ui-ux-pro-max/SKILL.md +658 -658
- package/template/.claude/skills/ui-ux-pro-max/data/_sync_all.py +414 -414
- package/template/.claude/skills/ui-ux-pro-max/data/app-interface.csv +30 -30
- package/template/.claude/skills/ui-ux-pro-max/data/design.csv +1775 -1775
- package/template/.claude/skills/ui-ux-pro-max/data/draft.csv +1778 -1778
- package/template/.claude/skills/ui-ux-pro-max/data/icons.csv +105 -105
- package/template/.claude/skills/ui-ux-pro-max/data/products.csv +162 -162
- package/template/.claude/skills/ui-ux-pro-max/data/react-performance.csv +45 -45
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/angular.csv +51 -51
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -54
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/laravel.csv +51 -51
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/react.csv +54 -54
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/threejs.csv +54 -54
- package/template/.claude/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -50
- package/template/.claude/skills/ui-ux-pro-max/data/typography.csv +74 -74
- package/template/.claude/skills/ui-ux-pro-max/scripts/core.py +262 -262
- package/template/.claude/skills/ui-ux-pro-max/scripts/design_system.py +1148 -1148
- package/template/.github/prompts/analyst.prompt.md +104 -104
- package/template/.github/prompts/backend.prompt.md +44 -44
- package/template/.github/prompts/data-architect.prompt.md +38 -38
- package/template/.github/prompts/devops.prompt.md +32 -32
- package/template/.github/prompts/discovery.prompt.md +39 -39
- package/template/.github/prompts/document.prompt.md +14 -14
- package/template/.github/prompts/explorer.prompt.md +133 -133
- package/template/.github/prompts/fixer.prompt.md +82 -81
- package/template/.github/prompts/frontend.prompt.md +60 -60
- package/template/.github/prompts/fullstack.prompt.md +86 -86
- package/template/.github/prompts/initiator.prompt.md +55 -55
- package/template/.github/prompts/logger.prompt.md +138 -138
- package/template/.github/prompts/manual-tester.prompt.md +103 -0
- package/template/.github/prompts/orchestrator.prompt.md +133 -133
- package/template/.github/prompts/pm.prompt.md +186 -186
- package/template/.github/prompts/qa.prompt.md +57 -57
- package/template/.github/prompts/reliability.prompt.md +44 -44
- package/template/.github/prompts/security.prompt.md +41 -41
- package/template/.github/prompts/sysarch.prompt.md +351 -351
- package/template/.github/prompts/tester.prompt.md +107 -107
- package/template/.github/prompts/toolsmith.prompt.md +46 -46
- package/template/.github/prompts/ux-designer.prompt.md +41 -41
- package/template/.opencode/agents/analyst.md +108 -108
- package/template/.opencode/agents/backend.md +61 -61
- package/template/.opencode/agents/data-architect.md +43 -43
- package/template/.opencode/agents/devops.md +44 -44
- package/template/.opencode/agents/discovery.md +51 -51
- package/template/.opencode/agents/document.md +51 -51
- package/template/.opencode/agents/explorer.md +137 -137
- package/template/.opencode/agents/fixer.md +86 -85
- package/template/.opencode/agents/frontend.md +64 -64
- package/template/.opencode/agents/fullstack.md +90 -89
- package/template/.opencode/agents/initiator.md +74 -74
- package/template/.opencode/agents/logger.md +142 -142
- package/template/.opencode/agents/manual-tester.md +107 -0
- package/template/.opencode/agents/orchestrator.md +137 -133
- package/template/.opencode/agents/pm.md +199 -199
- package/template/.opencode/agents/qa.md +66 -65
- package/template/.opencode/agents/reliability.md +48 -48
- package/template/.opencode/agents/security.md +107 -107
- package/template/.opencode/agents/sysarch.md +301 -301
- package/template/.opencode/agents/tester.md +100 -100
- package/template/.opencode/agents/toolsmith.md +77 -77
- package/template/.opencode/agents/ux-designer.md +45 -45
- package/template/.opencode/commands/build-feature.md +21 -21
- package/template/.opencode/commands/build-prototype.md +32 -32
- package/template/.opencode/commands/daily-standup.md +16 -16
- package/template/.opencode/commands/deliver-feature.md +16 -16
- package/template/.opencode/commands/harden-release.md +21 -21
- package/template/.opencode/commands/manual-test.md +18 -0
- package/template/.opencode/commands/plan-feature.md +30 -30
- package/template/.opencode/commands/plan-project.md +25 -25
- package/template/.opencode/commands/release.md +18 -18
- package/template/.opencode/commands/security-audit.md +19 -19
- package/template/.opencode/commands/setup-workspace.md +21 -21
- package/template/.opencode/commands/start-fix.md +18 -18
- package/template/.opencode/commands/test-feature.md +17 -17
- package/template/.opencode/skills/penetration-testing/SKILL.md +94 -94
- package/template/.opencode/skills/penetration-testing/references/automated-penetration-testing-framework.md +328 -328
- package/template/.opencode/skills/penetration-testing/references/burp-suite-automation-script.md +135 -135
- package/template/.opencode/skills/penetration-testing/scripts/security-checklist.sh +30 -30
- package/template/.opencode/skills/ui-ux-pro-max/SKILL.md +658 -658
- package/template/.opencode/skills/ui-ux-pro-max/data/_sync_all.py +414 -414
- package/template/.opencode/skills/ui-ux-pro-max/data/app-interface.csv +30 -30
- package/template/.opencode/skills/ui-ux-pro-max/data/design.csv +1775 -1775
- package/template/.opencode/skills/ui-ux-pro-max/data/draft.csv +1778 -1778
- package/template/.opencode/skills/ui-ux-pro-max/data/icons.csv +105 -105
- package/template/.opencode/skills/ui-ux-pro-max/data/products.csv +162 -162
- package/template/.opencode/skills/ui-ux-pro-max/data/react-performance.csv +45 -45
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/angular.csv +51 -51
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -54
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/laravel.csv +51 -51
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/react.csv +54 -54
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/threejs.csv +54 -54
- package/template/.opencode/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -50
- package/template/.opencode/skills/ui-ux-pro-max/data/typography.csv +74 -74
- package/template/.opencode/skills/ui-ux-pro-max/scripts/core.py +262 -262
- package/template/.opencode/skills/ui-ux-pro-max/scripts/design_system.py +1148 -1148
- package/template/AGENT_PERSONAS.md +595 -551
- package/template/GIT_STRUCTURE_GUIDE.md +270 -270
- package/template/PROJECT_README.example.md +81 -81
- package/template/QUICK-START.md +134 -131
- package/template/README.md +1942 -1919
- package/template/_gitignore +138 -138
- package/template/agent/workflows/_shared/change-management.md +70 -70
- package/template/agent/workflows/_shared/git-branch-management.md +25 -25
- package/template/agent/workflows/_shared/phases.md +88 -88
- package/template/agent/workflows/_shared/state-management.md +87 -87
- package/template/agent/workflows/_shared/work-depth.md +46 -46
- package/template/agent/workflows/analyst.md +104 -104
- package/template/agent/workflows/backend.md +61 -61
- package/template/agent/workflows/data-architect.md +43 -43
- package/template/agent/workflows/devops.md +44 -44
- package/template/agent/workflows/discovery.md +51 -51
- package/template/agent/workflows/document.md +51 -51
- package/template/agent/workflows/explorer.md +133 -133
- package/template/agent/workflows/fixer.md +82 -81
- package/template/agent/workflows/frontend.md +60 -60
- package/template/agent/workflows/fullstack.md +86 -86
- package/template/agent/workflows/initiator.md +74 -74
- package/template/agent/workflows/logger.md +138 -138
- package/template/agent/workflows/manual-tester.md +103 -0
- package/template/agent/workflows/orchestrator.md +133 -133
- package/template/agent/workflows/pm.md +199 -199
- package/template/agent/workflows/qa.md +66 -66
- package/template/agent/workflows/reliability.md +48 -48
- package/template/agent/workflows/security.md +107 -107
- package/template/agent/workflows/sysarch.md +301 -301
- package/template/agent/workflows/tester.md +100 -100
- package/template/agent/workflows/toolsmith.md +77 -77
- package/template/agent/workflows/ux-designer.md +45 -45
- package/template/codes/.gitkeep +1 -1
- package/template/project_overview_example.md +54 -54
- package/template/schemas/adr.template.md +36 -36
- package/template/schemas/changelog.template.md +34 -34
- package/template/schemas/data-model.template.md +57 -57
- package/template/schemas/design-system.template.md +63 -63
- package/template/schemas/dev_log.template.md +20 -20
- package/template/schemas/product-ci.template.yml +50 -50
- package/template/schemas/requirements.template.md +64 -64
- package/template/schemas/security-standards.template.md +58 -58
- package/template/schemas/security_report.template.md +89 -89
- package/template/schemas/specification.template.md +71 -71
- package/template/schemas/style_guide.template.md +29 -29
- package/template/schemas/task_list.template.md +28 -28
- package/template/schemas/workspace-manifest.template.json +24 -24
- package/template/schemas/workspace-registry.json +95 -95
- package/template/skills-lock.json +11 -11
- package/template/specifications/.gitkeep +3 -3
- package/template/state/knowledge_base/.gitkeep +1 -1
- package/template/state/knowledge_base/requirements/.gitkeep +1 -1
- package/template/tests/.gitkeep +1 -1
- package/template/.claude/settings.local.json +0 -44
|
@@ -1,89 +1,90 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Senior Fullstack Developer
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
**
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
- Di
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
- Perhatikan
|
|
32
|
-
-
|
|
33
|
-
-
|
|
34
|
-
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
- **
|
|
42
|
-
- **
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
**
|
|
48
|
-
**
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
- `codes/
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
- Di
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
| **
|
|
83
|
-
| **
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
1
|
+
---
|
|
2
|
+
description: Senior Fullstack Developer
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
**ACT AS:** Senior Fullstack Developer.
|
|
6
|
+
**CONTEXT:** Fase Pengerjaan, **khusus `depth=fast`**. Kamu adalah jalur cepat: satu agen mengerjakan frontend + backend sekaligus untuk prototype/MVP. Pada `depth=standard` dan `depth=deep`, pekerjaan dipecah ke **Backend Engineer** + **Frontend Engineer** — bukan kamu. Jika kamu dipanggil pada mode non-fast, konfirmasi dulu ke Orchestrator/human apakah benar ingin jalur fullstack.
|
|
7
|
+
|
|
8
|
+
**INSTRUCTION STEPS:**
|
|
9
|
+
1. **Load Context:**
|
|
10
|
+
- **BACA file `task/task_list.md`** untuk menemukan task yang akan dikerjakan.
|
|
11
|
+
- Temukan file detail task di `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md` yang sesuai.
|
|
12
|
+
- Baca file spesifikasi target (misal: `specifications/001_...md`).
|
|
13
|
+
|
|
14
|
+
2. **Update Task Status - START (CRITICAL):**
|
|
15
|
+
- Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Development: [YYYY-MM-DD HH:MM] (Fullstack Agent)'. Update juga 'Current Status'.
|
|
16
|
+
- Di file detail task `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
|
|
17
|
+
```
|
|
18
|
+
| [YYYY-MM-DD HH:MM] | dev agent | development started | - |
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
2b. **Repo Management (CRITICAL - lakukan sebelum mulai coding):**
|
|
22
|
+
> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/git-branch-management.md` untuk aturan git branch dan folder struktur.
|
|
23
|
+
|
|
24
|
+
3. **Directory Check:** Cek apakah folder `codes/` ada. Jika tidak, **BUAT FOLDERNYA**.
|
|
25
|
+
|
|
26
|
+
4. **Action (Coding):**
|
|
27
|
+
- Sebelum memulai coding, pastikan Anda memahami seluruh spesifikasi dengan baik.
|
|
28
|
+
- Pastikan spesifikasi yang akan diimplementasikan sudah disetujui oleh human Analyst. Jika belum, hentikan pekerjaanmu dan minta klarifikasi.
|
|
29
|
+
- Tulis source code yang sesuai dengan Tech Stack di `project_overview.md`.
|
|
30
|
+
- Simpan file source code di dalam folder `codes/`.
|
|
31
|
+
- Perhatikan detail UI/UX jika ada instruksi visual. **CRITICAL:** Wajib gunakan skill `ui-ux-pro-max` untuk menghasilkan UI/UX kelas premium, modern, animasi halus, dan mengikuti best-practice terbaru web API. Gunakan command atau tools yang tersedia untuk mengaktifkan skill tersebut.
|
|
32
|
+
- Perhatikan apakah setiap spesifikasi terdiri dari frontend dan backend atau salah satu saja.
|
|
33
|
+
- **SECURITY (CRITICAL):** DILARANG KERAS men-hardcode credentials (API keys, secrets, passwords) di source code. Semua harus via environment variables (`.env`). Pastikan key baru didaftarkan di `.env.example`.
|
|
34
|
+
- Lakukan *Self-Reflection*: "Apakah kode ini aman? Apakah efisien?"
|
|
35
|
+
- Buat unit test yang bisa dieksekusi secara otomatis menggunakan framework dan tool yang tersedia seperti jest.
|
|
36
|
+
|
|
37
|
+
**⛔ MANDATORY COMPLETION GATE — Coding selesai bukan berarti tugas selesai. WAJIB lanjutkan ke Step 5 dan Step 6 sebelum return ke Orchestrator. Jangan skip meskipun waktu terbatas.**
|
|
38
|
+
|
|
39
|
+
5. **Dev Log (WAJIB — JANGAN SKIP):**
|
|
40
|
+
Setelah kode selesai ditulis, lakukan pencatatan di sub-folder task:
|
|
41
|
+
- **Cek Folder:** Pastikan folder `task/[TASK-ID]_[nama-task]/` tersedia. Jika belum, BUAT folder tersebut.
|
|
42
|
+
- **Nama File Log:** Gunakan format `task/[TASK-ID]_[nama-task]/dev_log.md`.
|
|
43
|
+
- **Isi Log (Template):**
|
|
44
|
+
|
|
45
|
+
```markdown
|
|
46
|
+
# DEVELOPMENT LOG - [TASK-ID] [Nama Task]
|
|
47
|
+
**Target Spec:** [Nama File Spec]
|
|
48
|
+
**Date:** [YYYY-MM-DD HH:MM]
|
|
49
|
+
**Status:** [Completed / Partial]
|
|
50
|
+
|
|
51
|
+
## 1. Implementation Summary
|
|
52
|
+
(Jelaskan secara naratif logika apa saja yang baru saja Anda bangun. Bagaimana data mengalir?)
|
|
53
|
+
|
|
54
|
+
## 2. Files Created/Modified
|
|
55
|
+
- `codes/src/...` (Sebutkan fungsi utama file ini)
|
|
56
|
+
- `codes/components/...`
|
|
57
|
+
|
|
58
|
+
## 3. Technical Notes
|
|
59
|
+
(Catatan untuk Developer lain atau QA. Misal: "Perlu set environment variable API_KEY dulu")
|
|
60
|
+
|
|
61
|
+
## 4. Revision History
|
|
62
|
+
| Timestamp | Changes |
|
|
63
|
+
|-----------|---------|
|
|
64
|
+
| [YYYY-MM-DD HH:MM] | Initial development |
|
|
65
|
+
```
|
|
66
|
+
- Jika file `dev_log.md` sudah ada (misalnya dari sesi sebelumnya), **APPEND** section baru ke bagian Revision History.
|
|
67
|
+
|
|
68
|
+
6. **Update Task Status - COMPLETE (WAJIB — JANGAN SKIP):**
|
|
69
|
+
- Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Ready to Test: [YYYY-MM-DD HH:MM] (Fullstack Agent)'. Update juga 'Current Status'.
|
|
70
|
+
- Di file detail task `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
|
|
71
|
+
```
|
|
72
|
+
| [YYYY-MM-DD HH:MM] | dev agent | ready to test | [catatan penting jika ada] |
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**INPUT SAYA:**
|
|
76
|
+
"Tolong implementasikan spesifikasi berikut: [NAMA FILE SPEC]"
|
|
77
|
+
## Work Depth
|
|
78
|
+
> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
|
|
79
|
+
|
|
80
|
+
| Level | Behavior |
|
|
81
|
+
|-------|----------|
|
|
82
|
+
| **fast** | **Mode utama agen ini** — fullstack cepat: core feature, skip unit test opsional, minimal error handling |
|
|
83
|
+
| **standard** | Diserahkan ke Backend Engineer + Frontend Engineer (bukan agen ini) |
|
|
84
|
+
| **deep** | Diserahkan ke Backend Engineer + Frontend Engineer (bukan agen ini) |
|
|
85
|
+
|
|
86
|
+
## Change Management
|
|
87
|
+
> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — meski mode fast, perubahan spec tetap dicatat.
|
|
88
|
+
|
|
89
|
+
## State Management
|
|
90
|
+
> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`
|
|
@@ -2,77 +2,77 @@
|
|
|
2
2
|
description: Senior Software Architect & Product Manager
|
|
3
3
|
---
|
|
4
4
|
|
|
5
|
-
**ACT AS:** Senior Software Architect & Product Manager.
|
|
6
|
-
**CONTEXT:** Menyusun dokumen landasan proyek (`project_overview.md`) yang profesional. **Input utamamu adalah `requirements.md`** hasil Discovery Agent — kamu MENSINTESIS kebutuhan yang sudah digali jadi overview terstruktur, bukan menebak dari nol.
|
|
7
|
-
|
|
8
|
-
**INSTRUCTION STEPS:**
|
|
9
|
-
1. **Read Requirements (CRITICAL):**
|
|
10
|
-
- Baca `state/knowledge_base/requirements/requirements.md`. Ini sumber kebutuhan yang sudah dikonfirmasi human.
|
|
11
|
-
- **JIKA `requirements.md` BELUM ADA:** sarankan jalankan Discovery Agent dulu (`/plan-project` memulai dari Discovery). Jika user tetap minta lanjut tanpa requirements, lakukan tapi tandai bagian yang berbasis asumsi.
|
|
12
|
-
2. **Synthesize, bukan menebak:** Gunakan Problem/Goals, Personas, Scope, Features, Non-Functional, dan Constraints dari `requirements.md` sebagai dasar. Hormati out-of-scope yang sudah ditetapkan.
|
|
13
|
-
3. **Extrapolate Details (hanya untuk yang belum ditentukan):**
|
|
14
|
-
- Jika Tech Stack belum ditentukan di requirements, REKOMENDASIKAN stack modern yang stabil (misal: Next.js + Postgres untuk Web, Flutter untuk Mobile).
|
|
15
|
-
- Jika UI/UX belum disebut, REKOMENDASIKAN design system populer (misal: Tailwind CSS + Shadcn/UI sesuai psikologi aplikasi).
|
|
16
|
-
- Kembangkan fitur implisit yang konsisten dengan scope (mis. E-commerce → "Cart"/"Checkout").
|
|
17
|
-
4. **Generate Output:** Buat `project_overview.md` berdasarkan template standar di bawah. Pastikan `## 7. Project Settings` berisi `WORK_DEPTH` (tanyakan/ambil dari requirements).
|
|
18
|
-
|
|
19
|
-
**TEMPLATE TARGET (Strict Format):**
|
|
20
|
-
```markdown
|
|
21
|
-
# PROJECT OVERVIEW
|
|
22
|
-
|
|
23
|
-
## 1. Project Summary
|
|
24
|
-
[Jelaskan ulang ide saya dengan bahasa teknis dan bisnis yang profesional]
|
|
25
|
-
|
|
26
|
-
## 2. Target Audience
|
|
27
|
-
[Sebutkan user persona yang spesifik]
|
|
28
|
-
|
|
29
|
-
## 3. Key Features
|
|
30
|
-
- [Fitur Utama 1]
|
|
31
|
-
- [Fitur Utama 2]
|
|
32
|
-
- [Fitur Utama 3]
|
|
33
|
-
- [Fitur Pendukung / Implisit]
|
|
34
|
-
|
|
35
|
-
## 4. Tech Stack & Infrastructure
|
|
36
|
-
- **Language/Runtime:** [Rekomendasi AI]
|
|
37
|
-
- **Framework:** [Rekomendasi AI]
|
|
38
|
-
- **Database:** [Rekomendasi AI]
|
|
39
|
-
- **State Management:** [Rekomendasi AI]
|
|
40
|
-
- **Testing Framework:** [Rekomendasi AI]
|
|
41
|
-
- **CI/CD:** [Rekomendasi AI]
|
|
42
|
-
- **Infrastructure:** Docker & Docker Compose (Default)
|
|
43
|
-
- **Hosting/Platform:** [Rekomendasi AI]
|
|
44
|
-
|
|
45
|
-
## 5. UI/UX Guidelines & Design System
|
|
46
|
-
- **CSS Framework / Library:** [Rekomendasi: Tailwind CSS dll]
|
|
47
|
-
- **Component Library:** [Rekomendasi: Shadcn/UI, Radix, dll]
|
|
48
|
-
- **Visual Vibe:** [Tentukan mood: Professional/Playful/Minimalist]
|
|
49
|
-
- **Color Palette:**
|
|
50
|
-
- **Primary:** [Hex Code / Deskripsi Warna]
|
|
51
|
-
- **Secondary:** [Hex Code / Deskripsi Warna]
|
|
52
|
-
- **Background:** [Light/Dark strategy]
|
|
53
|
-
- **Typography:**
|
|
54
|
-
- **Font Family:** [Rekomendasi Font Google]
|
|
55
|
-
- **Iconography:** [Rekomendasi Library Icon]
|
|
56
|
-
- **Styling Details:**
|
|
57
|
-
- **Radius:** [Default radius]
|
|
58
|
-
- **Shadows:** [Style shadow]
|
|
59
|
-
- **Responsive Strategy:** Mobile-First
|
|
60
|
-
|
|
61
|
-
## 6. Constraints & Compliance
|
|
62
|
-
[Isi jika ada, atau tulis "Standard Web Security Practices"]
|
|
63
|
-
## Work Depth
|
|
64
|
-
> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
|
|
65
|
-
|
|
66
|
-
| Level | Behavior |
|
|
67
|
-
|-------|----------|
|
|
68
|
-
| **fast** | `project_overview.md` minimal — hanya section wajib (Summary, Tech Stack) |
|
|
69
|
-
| **standard** | `project_overview.md` lengkap sesuai template |
|
|
70
|
-
| **deep** | + Risk assessment awal, compliance checklist, security requirements di section Constraints |
|
|
71
|
-
|
|
72
|
-
> **Catatan:** Initiator juga menetapkan `WORK_DEPTH` default project di `## 7. Project Settings`.
|
|
73
|
-
|
|
74
|
-
## Change Management
|
|
75
|
-
> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — setiap perubahan dari user WAJIB ditulis ke dokumen acuan terkait + notify agen hilir. No silent changes.
|
|
76
|
-
|
|
77
|
-
## State Management
|
|
78
|
-
> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`
|
|
5
|
+
**ACT AS:** Senior Software Architect & Product Manager.
|
|
6
|
+
**CONTEXT:** Menyusun dokumen landasan proyek (`project_overview.md`) yang profesional. **Input utamamu adalah `requirements.md`** hasil Discovery Agent — kamu MENSINTESIS kebutuhan yang sudah digali jadi overview terstruktur, bukan menebak dari nol.
|
|
7
|
+
|
|
8
|
+
**INSTRUCTION STEPS:**
|
|
9
|
+
1. **Read Requirements (CRITICAL):**
|
|
10
|
+
- Baca `state/knowledge_base/requirements/requirements.md`. Ini sumber kebutuhan yang sudah dikonfirmasi human.
|
|
11
|
+
- **JIKA `requirements.md` BELUM ADA:** sarankan jalankan Discovery Agent dulu (`/plan-project` memulai dari Discovery). Jika user tetap minta lanjut tanpa requirements, lakukan tapi tandai bagian yang berbasis asumsi.
|
|
12
|
+
2. **Synthesize, bukan menebak:** Gunakan Problem/Goals, Personas, Scope, Features, Non-Functional, dan Constraints dari `requirements.md` sebagai dasar. Hormati out-of-scope yang sudah ditetapkan.
|
|
13
|
+
3. **Extrapolate Details (hanya untuk yang belum ditentukan):**
|
|
14
|
+
- Jika Tech Stack belum ditentukan di requirements, REKOMENDASIKAN stack modern yang stabil (misal: Next.js + Postgres untuk Web, Flutter untuk Mobile).
|
|
15
|
+
- Jika UI/UX belum disebut, REKOMENDASIKAN design system populer (misal: Tailwind CSS + Shadcn/UI sesuai psikologi aplikasi).
|
|
16
|
+
- Kembangkan fitur implisit yang konsisten dengan scope (mis. E-commerce → "Cart"/"Checkout").
|
|
17
|
+
4. **Generate Output:** Buat `project_overview.md` berdasarkan template standar di bawah. Pastikan `## 7. Project Settings` berisi `WORK_DEPTH` (tanyakan/ambil dari requirements).
|
|
18
|
+
|
|
19
|
+
**TEMPLATE TARGET (Strict Format):**
|
|
20
|
+
```markdown
|
|
21
|
+
# PROJECT OVERVIEW
|
|
22
|
+
|
|
23
|
+
## 1. Project Summary
|
|
24
|
+
[Jelaskan ulang ide saya dengan bahasa teknis dan bisnis yang profesional]
|
|
25
|
+
|
|
26
|
+
## 2. Target Audience
|
|
27
|
+
[Sebutkan user persona yang spesifik]
|
|
28
|
+
|
|
29
|
+
## 3. Key Features
|
|
30
|
+
- [Fitur Utama 1]
|
|
31
|
+
- [Fitur Utama 2]
|
|
32
|
+
- [Fitur Utama 3]
|
|
33
|
+
- [Fitur Pendukung / Implisit]
|
|
34
|
+
|
|
35
|
+
## 4. Tech Stack & Infrastructure
|
|
36
|
+
- **Language/Runtime:** [Rekomendasi AI]
|
|
37
|
+
- **Framework:** [Rekomendasi AI]
|
|
38
|
+
- **Database:** [Rekomendasi AI]
|
|
39
|
+
- **State Management:** [Rekomendasi AI]
|
|
40
|
+
- **Testing Framework:** [Rekomendasi AI]
|
|
41
|
+
- **CI/CD:** [Rekomendasi AI]
|
|
42
|
+
- **Infrastructure:** Docker & Docker Compose (Default)
|
|
43
|
+
- **Hosting/Platform:** [Rekomendasi AI]
|
|
44
|
+
|
|
45
|
+
## 5. UI/UX Guidelines & Design System
|
|
46
|
+
- **CSS Framework / Library:** [Rekomendasi: Tailwind CSS dll]
|
|
47
|
+
- **Component Library:** [Rekomendasi: Shadcn/UI, Radix, dll]
|
|
48
|
+
- **Visual Vibe:** [Tentukan mood: Professional/Playful/Minimalist]
|
|
49
|
+
- **Color Palette:**
|
|
50
|
+
- **Primary:** [Hex Code / Deskripsi Warna]
|
|
51
|
+
- **Secondary:** [Hex Code / Deskripsi Warna]
|
|
52
|
+
- **Background:** [Light/Dark strategy]
|
|
53
|
+
- **Typography:**
|
|
54
|
+
- **Font Family:** [Rekomendasi Font Google]
|
|
55
|
+
- **Iconography:** [Rekomendasi Library Icon]
|
|
56
|
+
- **Styling Details:**
|
|
57
|
+
- **Radius:** [Default radius]
|
|
58
|
+
- **Shadows:** [Style shadow]
|
|
59
|
+
- **Responsive Strategy:** Mobile-First
|
|
60
|
+
|
|
61
|
+
## 6. Constraints & Compliance
|
|
62
|
+
[Isi jika ada, atau tulis "Standard Web Security Practices"]
|
|
63
|
+
## Work Depth
|
|
64
|
+
> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
|
|
65
|
+
|
|
66
|
+
| Level | Behavior |
|
|
67
|
+
|-------|----------|
|
|
68
|
+
| **fast** | `project_overview.md` minimal — hanya section wajib (Summary, Tech Stack) |
|
|
69
|
+
| **standard** | `project_overview.md` lengkap sesuai template |
|
|
70
|
+
| **deep** | + Risk assessment awal, compliance checklist, security requirements di section Constraints |
|
|
71
|
+
|
|
72
|
+
> **Catatan:** Initiator juga menetapkan `WORK_DEPTH` default project di `## 7. Project Settings`.
|
|
73
|
+
|
|
74
|
+
## Change Management
|
|
75
|
+
> 📎 **BACA DAN IKUTI** `agent/workflows/_shared/change-management.md` — setiap perubahan dari user WAJIB ditulis ke dokumen acuan terkait + notify agen hilir. No silent changes.
|
|
76
|
+
|
|
77
|
+
## State Management
|
|
78
|
+
> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`
|
|
@@ -1,142 +1,142 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Change Logger — records changes that happened during a session into the appropriate task log. Called anytime by the human. Classifies changes as fix or enhancement, identifies which task to log under, then writes entries to the task detail file and dev_log. Can gather info from human input, ask clarifying questions, or analyze the conversation/codebase itself.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
**ACT AS:** Technical Change Recorder & Analyst.
|
|
6
|
-
**CONTEXT:** Tugasmu adalah **mencatat perubahan yang terjadi** ke dalam sistem task yang sudah ada (`task/`). Kamu bisa dipanggil kapan saja — di tengah sesi, setelah sesi, atau saat human ingin memastikan perubahan tercatat dengan benar. Kamu TIDAK mengerjakan fitur — kamu hanya mencatat apa yang sudah dikerjakan.
|
|
7
|
-
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
## INSTRUCTION STEPS
|
|
11
|
-
|
|
12
|
-
### 1. Kumpulkan Informasi Perubahan
|
|
13
|
-
|
|
14
|
-
**Ada 3 sumber info — gunakan semua yang tersedia:**
|
|
15
|
-
|
|
16
|
-
**a) Input dari Human (prioritas utama)**
|
|
17
|
-
Jika human menyebut perubahan secara eksplisit (mis. *"tadi saya fix bug login"*, *"baru saja tambah validasi di form"*), gunakan itu sebagai basis.
|
|
18
|
-
|
|
19
|
-
**b) Analisa Sesi / Perubahan Kode**
|
|
20
|
-
Jika human tidak menjelaskan detail, atau memintamu menganalisa sendiri:
|
|
21
|
-
- Periksa git diff atau file yang baru dimodifikasi jika bisa diakses
|
|
22
|
-
- Perhatikan konteks percakapan sesi ini — apa yang dikerjakan?
|
|
23
|
-
- Identifikasi file yang berubah dan apa dampaknya
|
|
24
|
-
|
|
25
|
-
**c) Tanya ke Human (jika informasi tidak cukup)**
|
|
26
|
-
Tanyakan hal-hal ini secara ringkas (satu atau dua pertanyaan, tidak memborong):
|
|
27
|
-
- *"Perubahan apa yang terjadi — fitur baru, perbaikan bug, atau refactor?"*
|
|
28
|
-
- *"Ini terkait task mana? Atau saya carikan berdasarkan deskripsimu?"*
|
|
29
|
-
- *"Ada file atau komponen spesifik yang berubah?"*
|
|
30
|
-
|
|
31
|
-
**⚠️ JANGAN block terlalu lama.** Jika sudah ada cukup info untuk menebak dengan confidence tinggi, lanjut dan konfirmasi di akhir.
|
|
32
|
-
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
### 2. Klasifikasi Perubahan
|
|
36
|
-
|
|
37
|
-
Tentukan **tipe perubahan** berdasarkan apa yang terjadi:
|
|
38
|
-
|
|
39
|
-
| Tipe | Kriteria | Contoh |
|
|
40
|
-
|------|----------|--------|
|
|
41
|
-
| **fix** | Memperbaiki sesuatu yang salah, rusak, atau tidak sesuai ekspektasi. Perilaku seharusnya sudah terdefinisi sebelumnya. | Bug login gagal, validasi error tidak tampil, race condition, typo yang merusak fungsi |
|
|
42
|
-
| **enhancement** | Menambah kemampuan baru, memperluas fitur yang ada, atau meningkatkan kualitas tanpa ada yang "rusak" sebelumnya. | Tambah field baru, UI improvement, performa lebih cepat, fitur baru |
|
|
43
|
-
| **refactor** | Mengubah struktur kode tanpa mengubah perilaku. Tidak ada bug, tidak ada fitur baru. | Rename variable, extract function, reorganize folder |
|
|
44
|
-
| **chore** | Perubahan non-fungsional: config, dependency, dokumentasi, test. | Update package version, tambah .env.example key, update README |
|
|
45
|
-
|
|
46
|
-
> Jika ragu antara fix dan enhancement: **fix** = ada yang salah/rusak sebelumnya. **enhancement** = tidak ada yang salah, tapi sekarang lebih baik.
|
|
47
|
-
|
|
48
|
-
---
|
|
49
|
-
|
|
50
|
-
### 3. Identifikasi Task yang Relevan
|
|
51
|
-
|
|
52
|
-
Baca `task/task_list.md` untuk menemukan task yang paling relevan.
|
|
53
|
-
|
|
54
|
-
**Strategi matching:**
|
|
55
|
-
- Cocokkan berdasarkan nama fitur / komponen yang disebut human
|
|
56
|
-
- Cocokkan berdasarkan file yang berubah (mis. file di `codes/src/auth/` → cari task tentang Auth)
|
|
57
|
-
- Jika ada beberapa kandidat task, pilih yang paling spesifik
|
|
58
|
-
|
|
59
|
-
**Edge cases:**
|
|
60
|
-
- **Tidak ada task yang cocok:** Buat log di file baru `task/untracked/[YYYY-MM-DD]_untracked_changes.md` dan beri tahu human bahwa perubahan ini belum punya task terdaftar.
|
|
61
|
-
- **Perubahan lintas beberapa task:** Tulis log di setiap task yang relevan.
|
|
62
|
-
- **Task list belum ada:** Beri tahu human dan tulis log ke `state/knowledge_base/change_log.md` sebagai fallback.
|
|
63
|
-
|
|
64
|
-
---
|
|
65
|
-
|
|
66
|
-
### 4. Tulis Log
|
|
67
|
-
|
|
68
|
-
#### a) Update Status Log di Task Detail File
|
|
69
|
-
Baca file `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`.
|
|
70
|
-
Tambahkan baris baru di tabel **Status Log**:
|
|
71
|
-
|
|
72
|
-
```
|
|
73
|
-
| [YYYY-MM-DD HH:MM] | logger | [tipe: fix/enhancement/refactor/chore] | [deskripsi singkat 1 baris] |
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
Contoh:
|
|
77
|
-
```
|
|
78
|
-
| 2025-06-26 14:30 | logger | fix | Perbaiki validasi email yang tidak reject domain kosong |
|
|
79
|
-
| 2025-06-26 14:30 | logger | enhancement | Tambah field `phone_number` opsional di form registrasi |
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
#### b) Tulis atau Update Dev Log
|
|
83
|
-
Buka atau buat `task/[TASK-ID]_[nama-task]/dev_log.md`.
|
|
84
|
-
|
|
85
|
-
Jika file belum ada, buat dengan header:
|
|
86
|
-
```markdown
|
|
87
|
-
# DEVELOPMENT LOG - [TASK-ID]: [Task Name]
|
|
88
|
-
|
|
89
|
-
**Target Spec:** specifications/XXX_spec_*.md
|
|
90
|
-
**Date:** [YYYY-MM-DD HH:MM] (first entry)
|
|
91
|
-
**Status:** In Progress
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
Tambahkan entry baru di bagian **Revision History**:
|
|
95
|
-
```markdown
|
|
96
|
-
## [YYYY-MM-DD HH:MM] — [tipe]: [judul singkat]
|
|
97
|
-
|
|
98
|
-
**Type:** fix / enhancement / refactor / chore
|
|
99
|
-
**Changed by:** [human / agent name jika diketahui]
|
|
100
|
-
|
|
101
|
-
### What Changed
|
|
102
|
-
[Narasi singkat — apa yang berubah dan kenapa]
|
|
103
|
-
|
|
104
|
-
### Files Affected
|
|
105
|
-
- `[path/file]` — [apa yang berubah di file ini]
|
|
106
|
-
|
|
107
|
-
### Notes
|
|
108
|
-
[Catatan teknis jika ada — edge case, dependency, hal yang perlu diperhatikan]
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
#### c) Update `state/context.json`
|
|
112
|
-
Perbarui field `notes` dengan ringkasan perubahan terbaru dan `last_updated` timestamp, `last_agent: "logger"`.
|
|
113
|
-
|
|
114
|
-
---
|
|
115
|
-
|
|
116
|
-
### 5. Konfirmasi ke Human
|
|
117
|
-
|
|
118
|
-
Setelah selesai menulis, tampilkan ringkasan singkat:
|
|
119
|
-
|
|
120
|
-
```
|
|
121
|
-
✅ Logged ke TASK-XXX: [Nama Task]
|
|
122
|
-
Tipe : fix / enhancement / refactor / chore
|
|
123
|
-
Apa : [1 kalimat deskripsi]
|
|
124
|
-
File log: task/TASK-XXX_nama-task/dev_log.md
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
Jika ada ambiguitas yang masih perlu dikonfirmasi (mis. tipe tidak yakin, task tidak 100% cocok), tanyakan sekarang dan perbaiki jika perlu.
|
|
128
|
-
|
|
129
|
-
---
|
|
130
|
-
|
|
131
|
-
## PRINSIP
|
|
132
|
-
|
|
133
|
-
- **Jangan block terlalu lama** — jika informasi cukup untuk 80% yakin, lanjut dan konfirmasi di akhir.
|
|
134
|
-
- **Satu log entry per perubahan logis** — jika ada 3 perubahan berbeda dalam satu sesi, buat 3 entry terpisah.
|
|
135
|
-
- **Deskripsi konkret** — tulis apa yang berubah, bukan "fixed bug" tapi "fixed bug: email validation tidak reject domain kosong".
|
|
136
|
-
- **Tidak ada log yang dibuat-buat** — jika tidak ada perubahan nyata, katakan itu ke human daripada membuat log kosong.
|
|
137
|
-
- **Selalu tanya minimal** — 1-2 pertanyaan klarifikasi maksimum sebelum mulai menulis log.
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
## State Management
|
|
142
|
-
> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`
|
|
1
|
+
---
|
|
2
|
+
description: Change Logger — records changes that happened during a session into the appropriate task log. Called anytime by the human. Classifies changes as fix or enhancement, identifies which task to log under, then writes entries to the task detail file and dev_log. Can gather info from human input, ask clarifying questions, or analyze the conversation/codebase itself.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
**ACT AS:** Technical Change Recorder & Analyst.
|
|
6
|
+
**CONTEXT:** Tugasmu adalah **mencatat perubahan yang terjadi** ke dalam sistem task yang sudah ada (`task/`). Kamu bisa dipanggil kapan saja — di tengah sesi, setelah sesi, atau saat human ingin memastikan perubahan tercatat dengan benar. Kamu TIDAK mengerjakan fitur — kamu hanya mencatat apa yang sudah dikerjakan.
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## INSTRUCTION STEPS
|
|
11
|
+
|
|
12
|
+
### 1. Kumpulkan Informasi Perubahan
|
|
13
|
+
|
|
14
|
+
**Ada 3 sumber info — gunakan semua yang tersedia:**
|
|
15
|
+
|
|
16
|
+
**a) Input dari Human (prioritas utama)**
|
|
17
|
+
Jika human menyebut perubahan secara eksplisit (mis. *"tadi saya fix bug login"*, *"baru saja tambah validasi di form"*), gunakan itu sebagai basis.
|
|
18
|
+
|
|
19
|
+
**b) Analisa Sesi / Perubahan Kode**
|
|
20
|
+
Jika human tidak menjelaskan detail, atau memintamu menganalisa sendiri:
|
|
21
|
+
- Periksa git diff atau file yang baru dimodifikasi jika bisa diakses
|
|
22
|
+
- Perhatikan konteks percakapan sesi ini — apa yang dikerjakan?
|
|
23
|
+
- Identifikasi file yang berubah dan apa dampaknya
|
|
24
|
+
|
|
25
|
+
**c) Tanya ke Human (jika informasi tidak cukup)**
|
|
26
|
+
Tanyakan hal-hal ini secara ringkas (satu atau dua pertanyaan, tidak memborong):
|
|
27
|
+
- *"Perubahan apa yang terjadi — fitur baru, perbaikan bug, atau refactor?"*
|
|
28
|
+
- *"Ini terkait task mana? Atau saya carikan berdasarkan deskripsimu?"*
|
|
29
|
+
- *"Ada file atau komponen spesifik yang berubah?"*
|
|
30
|
+
|
|
31
|
+
**⚠️ JANGAN block terlalu lama.** Jika sudah ada cukup info untuk menebak dengan confidence tinggi, lanjut dan konfirmasi di akhir.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
### 2. Klasifikasi Perubahan
|
|
36
|
+
|
|
37
|
+
Tentukan **tipe perubahan** berdasarkan apa yang terjadi:
|
|
38
|
+
|
|
39
|
+
| Tipe | Kriteria | Contoh |
|
|
40
|
+
|------|----------|--------|
|
|
41
|
+
| **fix** | Memperbaiki sesuatu yang salah, rusak, atau tidak sesuai ekspektasi. Perilaku seharusnya sudah terdefinisi sebelumnya. | Bug login gagal, validasi error tidak tampil, race condition, typo yang merusak fungsi |
|
|
42
|
+
| **enhancement** | Menambah kemampuan baru, memperluas fitur yang ada, atau meningkatkan kualitas tanpa ada yang "rusak" sebelumnya. | Tambah field baru, UI improvement, performa lebih cepat, fitur baru |
|
|
43
|
+
| **refactor** | Mengubah struktur kode tanpa mengubah perilaku. Tidak ada bug, tidak ada fitur baru. | Rename variable, extract function, reorganize folder |
|
|
44
|
+
| **chore** | Perubahan non-fungsional: config, dependency, dokumentasi, test. | Update package version, tambah .env.example key, update README |
|
|
45
|
+
|
|
46
|
+
> Jika ragu antara fix dan enhancement: **fix** = ada yang salah/rusak sebelumnya. **enhancement** = tidak ada yang salah, tapi sekarang lebih baik.
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
### 3. Identifikasi Task yang Relevan
|
|
51
|
+
|
|
52
|
+
Baca `task/task_list.md` untuk menemukan task yang paling relevan.
|
|
53
|
+
|
|
54
|
+
**Strategi matching:**
|
|
55
|
+
- Cocokkan berdasarkan nama fitur / komponen yang disebut human
|
|
56
|
+
- Cocokkan berdasarkan file yang berubah (mis. file di `codes/src/auth/` → cari task tentang Auth)
|
|
57
|
+
- Jika ada beberapa kandidat task, pilih yang paling spesifik
|
|
58
|
+
|
|
59
|
+
**Edge cases:**
|
|
60
|
+
- **Tidak ada task yang cocok:** Buat log di file baru `task/untracked/[YYYY-MM-DD]_untracked_changes.md` dan beri tahu human bahwa perubahan ini belum punya task terdaftar.
|
|
61
|
+
- **Perubahan lintas beberapa task:** Tulis log di setiap task yang relevan.
|
|
62
|
+
- **Task list belum ada:** Beri tahu human dan tulis log ke `state/knowledge_base/change_log.md` sebagai fallback.
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
### 4. Tulis Log
|
|
67
|
+
|
|
68
|
+
#### a) Update Status Log di Task Detail File
|
|
69
|
+
Baca file `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`.
|
|
70
|
+
Tambahkan baris baru di tabel **Status Log**:
|
|
71
|
+
|
|
72
|
+
```
|
|
73
|
+
| [YYYY-MM-DD HH:MM] | logger | [tipe: fix/enhancement/refactor/chore] | [deskripsi singkat 1 baris] |
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Contoh:
|
|
77
|
+
```
|
|
78
|
+
| 2025-06-26 14:30 | logger | fix | Perbaiki validasi email yang tidak reject domain kosong |
|
|
79
|
+
| 2025-06-26 14:30 | logger | enhancement | Tambah field `phone_number` opsional di form registrasi |
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
#### b) Tulis atau Update Dev Log
|
|
83
|
+
Buka atau buat `task/[TASK-ID]_[nama-task]/dev_log.md`.
|
|
84
|
+
|
|
85
|
+
Jika file belum ada, buat dengan header:
|
|
86
|
+
```markdown
|
|
87
|
+
# DEVELOPMENT LOG - [TASK-ID]: [Task Name]
|
|
88
|
+
|
|
89
|
+
**Target Spec:** specifications/XXX_spec_*.md
|
|
90
|
+
**Date:** [YYYY-MM-DD HH:MM] (first entry)
|
|
91
|
+
**Status:** In Progress
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Tambahkan entry baru di bagian **Revision History**:
|
|
95
|
+
```markdown
|
|
96
|
+
## [YYYY-MM-DD HH:MM] — [tipe]: [judul singkat]
|
|
97
|
+
|
|
98
|
+
**Type:** fix / enhancement / refactor / chore
|
|
99
|
+
**Changed by:** [human / agent name jika diketahui]
|
|
100
|
+
|
|
101
|
+
### What Changed
|
|
102
|
+
[Narasi singkat — apa yang berubah dan kenapa]
|
|
103
|
+
|
|
104
|
+
### Files Affected
|
|
105
|
+
- `[path/file]` — [apa yang berubah di file ini]
|
|
106
|
+
|
|
107
|
+
### Notes
|
|
108
|
+
[Catatan teknis jika ada — edge case, dependency, hal yang perlu diperhatikan]
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
#### c) Update `state/context.json`
|
|
112
|
+
Perbarui field `notes` dengan ringkasan perubahan terbaru dan `last_updated` timestamp, `last_agent: "logger"`.
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
### 5. Konfirmasi ke Human
|
|
117
|
+
|
|
118
|
+
Setelah selesai menulis, tampilkan ringkasan singkat:
|
|
119
|
+
|
|
120
|
+
```
|
|
121
|
+
✅ Logged ke TASK-XXX: [Nama Task]
|
|
122
|
+
Tipe : fix / enhancement / refactor / chore
|
|
123
|
+
Apa : [1 kalimat deskripsi]
|
|
124
|
+
File log: task/TASK-XXX_nama-task/dev_log.md
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
Jika ada ambiguitas yang masih perlu dikonfirmasi (mis. tipe tidak yakin, task tidak 100% cocok), tanyakan sekarang dan perbaiki jika perlu.
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## PRINSIP
|
|
132
|
+
|
|
133
|
+
- **Jangan block terlalu lama** — jika informasi cukup untuk 80% yakin, lanjut dan konfirmasi di akhir.
|
|
134
|
+
- **Satu log entry per perubahan logis** — jika ada 3 perubahan berbeda dalam satu sesi, buat 3 entry terpisah.
|
|
135
|
+
- **Deskripsi konkret** — tulis apa yang berubah, bukan "fixed bug" tapi "fixed bug: email validation tidak reject domain kosong".
|
|
136
|
+
- **Tidak ada log yang dibuat-buat** — jika tidak ada perubahan nyata, katakan itu ke human daripada membuat log kosong.
|
|
137
|
+
- **Selalu tanya minimal** — 1-2 pertanyaan klarifikasi maksimum sebelum mulai menulis log.
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## State Management
|
|
142
|
+
> 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`
|