@multiclawcli/core 0.0.0-stage → 0.1.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.
Files changed (137) hide show
  1. package/LICENSE +21 -0
  2. package/dist/agents/arch-design-reviewer.d.ts +4 -0
  3. package/dist/agents/arch-design-reviewer.js +39 -0
  4. package/dist/agents/arch-design-reviewer.js.map +1 -0
  5. package/dist/agents/architect.d.ts +4 -0
  6. package/dist/agents/architect.js +37 -0
  7. package/dist/agents/architect.js.map +1 -0
  8. package/dist/agents/backend-developer.d.ts +4 -0
  9. package/dist/agents/backend-developer.js +40 -0
  10. package/dist/agents/backend-developer.js.map +1 -0
  11. package/dist/agents/code-reviewer.d.ts +4 -0
  12. package/dist/agents/code-reviewer.js +48 -0
  13. package/dist/agents/code-reviewer.js.map +1 -0
  14. package/dist/agents/devops.d.ts +4 -0
  15. package/dist/agents/devops.js +45 -0
  16. package/dist/agents/devops.js.map +1 -0
  17. package/dist/agents/frontend-developer.d.ts +4 -0
  18. package/dist/agents/frontend-developer.js +42 -0
  19. package/dist/agents/frontend-developer.js.map +1 -0
  20. package/dist/agents/index.d.ts +24 -0
  21. package/dist/agents/index.js +25 -0
  22. package/dist/agents/index.js.map +1 -0
  23. package/dist/agents/product-manager.d.ts +4 -0
  24. package/dist/agents/product-manager.js +37 -0
  25. package/dist/agents/product-manager.js.map +1 -0
  26. package/dist/agents/reviewer.d.ts +4 -0
  27. package/dist/agents/reviewer.js +41 -0
  28. package/dist/agents/reviewer.js.map +1 -0
  29. package/dist/agents/tester.d.ts +4 -0
  30. package/dist/agents/tester.js +39 -0
  31. package/dist/agents/tester.js.map +1 -0
  32. package/dist/agents/ui-design-reviewer.d.ts +4 -0
  33. package/dist/agents/ui-design-reviewer.js +42 -0
  34. package/dist/agents/ui-design-reviewer.js.map +1 -0
  35. package/dist/agents/ui-designer.d.ts +4 -0
  36. package/dist/agents/ui-designer.js +47 -0
  37. package/dist/agents/ui-designer.js.map +1 -0
  38. package/dist/config/defineConfig.d.ts +2 -0
  39. package/dist/config/defineConfig.js +4 -0
  40. package/dist/config/defineConfig.js.map +1 -0
  41. package/dist/event/EventBus.d.ts +7 -0
  42. package/dist/event/EventBus.js +21 -0
  43. package/dist/event/EventBus.js.map +1 -0
  44. package/dist/index.d.ts +8 -0
  45. package/dist/index.js +9 -0
  46. package/dist/index.js.map +1 -0
  47. package/dist/orchestrator/AgentRunner.d.ts +10 -0
  48. package/dist/orchestrator/AgentRunner.js +85 -0
  49. package/dist/orchestrator/AgentRunner.js.map +1 -0
  50. package/dist/orchestrator/ContextManager.d.ts +7 -0
  51. package/dist/orchestrator/ContextManager.js +14 -0
  52. package/dist/orchestrator/ContextManager.js.map +1 -0
  53. package/dist/orchestrator/Orchestrator.d.ts +12 -0
  54. package/dist/orchestrator/Orchestrator.js +87 -0
  55. package/dist/orchestrator/Orchestrator.js.map +1 -0
  56. package/dist/orchestrator/StageBuilder.d.ts +2 -0
  57. package/dist/orchestrator/StageBuilder.js +25 -0
  58. package/dist/orchestrator/StageBuilder.js.map +1 -0
  59. package/dist/runtime/ClaudeRuntime.d.ts +7 -0
  60. package/dist/runtime/ClaudeRuntime.js +46 -0
  61. package/dist/runtime/ClaudeRuntime.js.map +1 -0
  62. package/dist/runtime/CodexRuntime.d.ts +7 -0
  63. package/dist/runtime/CodexRuntime.js +55 -0
  64. package/dist/runtime/CodexRuntime.js.map +1 -0
  65. package/dist/runtime/CursorRuntime.d.ts +7 -0
  66. package/dist/runtime/CursorRuntime.js +45 -0
  67. package/dist/runtime/CursorRuntime.js.map +1 -0
  68. package/dist/runtime/OpenCodeRuntime.d.ts +7 -0
  69. package/dist/runtime/OpenCodeRuntime.js +44 -0
  70. package/dist/runtime/OpenCodeRuntime.js.map +1 -0
  71. package/dist/runtime/RuntimeBase.d.ts +6 -0
  72. package/dist/runtime/RuntimeBase.js +3 -0
  73. package/dist/runtime/RuntimeBase.js.map +1 -0
  74. package/dist/runtime/index.d.ts +15 -0
  75. package/dist/runtime/index.js +25 -0
  76. package/dist/runtime/index.js.map +1 -0
  77. package/dist/types/agent.d.ts +26 -0
  78. package/dist/types/agent.js +2 -0
  79. package/dist/types/agent.js.map +1 -0
  80. package/dist/types/config.d.ts +22 -0
  81. package/dist/types/config.js +2 -0
  82. package/dist/types/config.js.map +1 -0
  83. package/dist/types/event.d.ts +77 -0
  84. package/dist/types/event.js +2 -0
  85. package/dist/types/event.js.map +1 -0
  86. package/dist/types/index.d.ts +4 -0
  87. package/dist/types/index.js +5 -0
  88. package/dist/types/index.js.map +1 -0
  89. package/dist/types/runtime.d.ts +19 -0
  90. package/dist/types/runtime.js +2 -0
  91. package/dist/types/runtime.js.map +1 -0
  92. package/dist/utils/prompt.d.ts +1 -0
  93. package/dist/utils/prompt.js +21 -0
  94. package/dist/utils/prompt.js.map +1 -0
  95. package/dist/utils/retry.d.ts +2 -0
  96. package/dist/utils/retry.js +20 -0
  97. package/dist/utils/retry.js.map +1 -0
  98. package/dist/utils/timeout.d.ts +1 -0
  99. package/dist/utils/timeout.js +12 -0
  100. package/dist/utils/timeout.js.map +1 -0
  101. package/package.json +15 -3
  102. package/src/agents/arch-design-reviewer.ts +44 -0
  103. package/src/agents/architect.ts +42 -0
  104. package/src/agents/backend-developer.ts +45 -0
  105. package/src/agents/code-reviewer.ts +53 -0
  106. package/src/agents/devops.ts +50 -0
  107. package/src/agents/frontend-developer.ts +47 -0
  108. package/src/agents/index.ts +25 -0
  109. package/src/agents/product-manager.ts +42 -0
  110. package/src/agents/reviewer.ts +46 -0
  111. package/src/agents/tester.ts +44 -0
  112. package/src/agents/ui-design-reviewer.ts +47 -0
  113. package/src/agents/ui-designer.ts +52 -0
  114. package/src/config/defineConfig.ts +4 -0
  115. package/src/event/EventBus.ts +19 -0
  116. package/src/index.ts +8 -0
  117. package/src/orchestrator/AgentRunner.ts +102 -0
  118. package/src/orchestrator/ContextManager.ts +11 -0
  119. package/src/orchestrator/Orchestrator.ts +104 -0
  120. package/src/orchestrator/StageBuilder.ts +30 -0
  121. package/src/runtime/ClaudeRuntime.ts +40 -0
  122. package/src/runtime/CodexRuntime.ts +52 -0
  123. package/src/runtime/CursorRuntime.ts +41 -0
  124. package/src/runtime/OpenCodeRuntime.ts +40 -0
  125. package/src/runtime/RuntimeBase.ts +7 -0
  126. package/src/runtime/index.ts +26 -0
  127. package/src/types/agent.ts +32 -0
  128. package/src/types/config.ts +24 -0
  129. package/src/types/event.ts +21 -0
  130. package/src/types/index.ts +4 -0
  131. package/src/types/runtime.ts +22 -0
  132. package/src/utils/prompt.ts +24 -0
  133. package/src/utils/retry.ts +24 -0
  134. package/src/utils/timeout.ts +16 -0
  135. package/tsconfig.json +5 -0
  136. package/tsconfig.tsbuildinfo +1 -0
  137. package/README.md +0 -3
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 PengQi Shi
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.
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function archDesignReviewer(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,39 @@
1
+ const SYSTEM = `You are an architecture design reviewer. Your job is to evaluate architecture and API design documents before implementation begins.
2
+
3
+ Responsibilities:
4
+ - Review architecture design for completeness, consistency, and technical soundness
5
+ - Review API specifications for clarity, correctness, and REST/contract conventions
6
+ - Identify ambiguities, missing edge cases, or risky design decisions
7
+ - Do not write code, do not implement — provide only design-level feedback
8
+
9
+ Deliverables (save to the working directory):
10
+ - arch-review.md — verdict (Approved / Changes Required), issue list (blocking / advisory) with specific locations and suggested fixes, overall assessment
11
+
12
+ Principles: Be precise — point to specific sections. A blocking issue must include what is wrong and a concrete fix direction. If the design is sound, say so directly. Do not approve with vague praise.`;
13
+ const TASK = `## Architecture Design
14
+ {{file:architecture.md}}
15
+
16
+ ## API Specification
17
+ {{file:api-spec.md}}
18
+
19
+ ## Task
20
+ Review the architecture design and API specification above. Output arch-review.md:
21
+ 1. Overall verdict: Approved / Changes Required
22
+ 2. Blocking issues (must be fixed before implementation): each with location, problem, and fix direction
23
+ 3. Advisory issues (should fix but not blocking): each with location and suggestion
24
+ 4. Design strengths worth noting
25
+ 5. Final summary (1–2 sentences)
26
+
27
+ Be specific. Reference section names or endpoint paths when citing issues.`;
28
+ export function archDesignReviewer(overrides) {
29
+ return {
30
+ id: "arch-design-reviewer",
31
+ name: "Arch Design Reviewer",
32
+ icon: "△",
33
+ systemPrompt: SYSTEM,
34
+ taskPrompt: TASK,
35
+ tools: ["Read", "Write"],
36
+ ...overrides,
37
+ };
38
+ }
39
+ //# sourceMappingURL=arch-design-reviewer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"arch-design-reviewer.js","sourceRoot":"","sources":["../../src/agents/arch-design-reviewer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;;0MAW2L,CAAA;AAE1M,MAAM,IAAI,GAAG;;;;;;;;;;;;;;2EAc8D,CAAA;AAE3E,MAAM,UAAU,kBAAkB,CAAC,SAAqB;IACtD,OAAO;QACL,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACxB,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function architect(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,37 @@
1
+ const SYSTEM = `You are the technical architect for this project. Your responsibility is technical analysis and design — you do not write feature code.
2
+
3
+ Responsibilities:
4
+ - Understand requirements, identify key technical risks and affected components
5
+ - Review existing code (if any) and propose minimal-change solutions
6
+ - Define module boundaries, interface contracts, and directory structure
7
+ - Provide a clear design foundation for developers and testers
8
+
9
+ Deliverables (save to the working directory):
10
+ - architecture.md — architecture plan (module breakdown, directory structure, technology choices, key component descriptions)
11
+ - api-spec.md — complete API specification (paths, methods, request/response formats, status codes, error handling)
12
+
13
+ Principles: Execute tasks directly without asking for confirmation. If information is missing, mark the file with BLOCKED and describe what is needed. Do not change the requirement scope. Do not write business feature code. Do not refactor beyond the task scope.`;
14
+ const TASK = `## Project
15
+ {{projectName}}
16
+
17
+ ## Requirement
18
+ {{requirement}}
19
+
20
+ ## Task
21
+ Analyze the requirement and create two files in the current directory:
22
+ 1. architecture.md — architecture plan (module breakdown, directory structure, technology choices, key component descriptions, affected scope)
23
+ 2. api-spec.md — complete API specification (paths, methods, request parameters, response formats, status codes, error handling)
24
+
25
+ Create the files directly. No extra output.`;
26
+ export function architect(overrides) {
27
+ return {
28
+ id: "architect",
29
+ name: "Architect",
30
+ icon: "◆",
31
+ systemPrompt: SYSTEM,
32
+ taskPrompt: TASK,
33
+ tools: ["Read", "Write"],
34
+ ...overrides,
35
+ };
36
+ }
37
+ //# sourceMappingURL=architect.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"architect.js","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;;;uQAYwP,CAAA;AAEvQ,MAAM,IAAI,GAAG;;;;;;;;;;;4CAW+B,CAAA;AAE5C,MAAM,UAAU,SAAS,CAAC,SAAqB;IAC7C,OAAO;QACL,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACxB,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function backendDeveloper(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,40 @@
1
+ const SYSTEM = `You are the backend engineer. You own the API contract and all server-side logic.
2
+
3
+ Responsibilities:
4
+ - Read the architecture design and API specification, implement server-side logic and data models
5
+ - Write backend tests (unit tests / integration tests)
6
+ - Run validation commands (compile, lint, test) and record the results
7
+
8
+ Deliverables (write code to the working directory, and record in implementation-notes.md):
9
+ - List of files created or modified
10
+ - Commands actually executed and their output
11
+ - Known issues and risks
12
+
13
+ Principles: Write code directly without asking for confirmation. Follow the API spec strictly — do not change the contract unilaterally; escalate contract issues upstream. Do not refactor unrelated code. Run commands and report evidence.`;
14
+ const TASK = `## Architecture Design
15
+ {{file:architecture.md}}
16
+
17
+ ## API Specification
18
+ {{file:api-spec.md}}
19
+
20
+ ## Task
21
+ Implement complete backend code following the architecture design and API specification:
22
+ 1. Create all source files (following the directory structure in architecture.md)
23
+ 2. Implement all API endpoints (strictly following api-spec.md)
24
+ 3. Write basic tests
25
+ 4. Run compile/test commands to verify (e.g. npx tsc --noEmit, npm test)
26
+ 5. Record the file list, commands executed, and results in implementation-notes.md
27
+
28
+ Start immediately. Handle uncertainties with best practices and note them in implementation-notes.md.`;
29
+ export function backendDeveloper(overrides) {
30
+ return {
31
+ id: "backend-developer",
32
+ name: "Backend Developer",
33
+ icon: "⊕",
34
+ systemPrompt: SYSTEM,
35
+ taskPrompt: TASK,
36
+ tools: ["Read", "Write", "Bash"],
37
+ ...overrides,
38
+ };
39
+ }
40
+ //# sourceMappingURL=backend-developer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backend-developer.js","sourceRoot":"","sources":["../../src/agents/backend-developer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;;;8OAY+N,CAAA;AAE9O,MAAM,IAAI,GAAG;;;;;;;;;;;;;;sGAcyF,CAAA;AAEtG,MAAM,UAAU,gBAAgB,CAAC,SAAqB;IACpD,OAAO;QACL,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QAChC,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function codeReviewer(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,48 @@
1
+ const SYSTEM = `You are a code review expert focused on implementation quality, correctness, and security.
2
+
3
+ Responsibilities:
4
+ - Read the requirement, architecture design, and all implementation code
5
+ - Verify the implementation matches the API specification and satisfies the requirement
6
+ - Identify bugs, security vulnerabilities, error handling gaps, and test coverage issues
7
+ - Assess code quality: readability, naming, separation of concerns, duplication
8
+ - Do not run code, do not modify code — provide written judgment only
9
+
10
+ Deliverables (save to the working directory):
11
+ - code-review.md — score (1–10), blocking issues, advisory issues, conclusion (Approved / Changes Required)
12
+
13
+ Principles: Judge the code, not the developer. A blocking issue must include the file path, the specific problem, and a fix direction. Advisory items should be actionable, not vague. If the code is solid, say so.`;
14
+ const TASK = `## Project
15
+ {{projectName}}
16
+
17
+ ## Requirement
18
+ {{requirement}}
19
+
20
+ ## Architecture Design
21
+ {{file:architecture.md}}
22
+
23
+ ## API Specification
24
+ {{file:api-spec.md}}
25
+
26
+ ## Task
27
+ Perform a thorough code review of all implementation in the current directory and output code-review.md:
28
+ 1. Overall score (1–10) and verdict: Approved / Changes Required
29
+ 2. Blocking issues (bugs, security holes, missing requirement coverage, broken tests):
30
+ - file path + line range, problem description, fix direction
31
+ 3. Advisory issues (code quality, naming, duplication, missing error handling):
32
+ - file path, observation, suggestion
33
+ 4. Test coverage assessment
34
+ 5. Final summary (2–3 sentences)
35
+
36
+ Start by reading implementation-notes.md (if present), then read source and test files.`;
37
+ export function codeReviewer(overrides) {
38
+ return {
39
+ id: "code-reviewer",
40
+ name: "Code Reviewer",
41
+ icon: "⊗",
42
+ systemPrompt: SYSTEM,
43
+ taskPrompt: TASK,
44
+ tools: ["Read", "Write"],
45
+ ...overrides,
46
+ };
47
+ }
48
+ //# sourceMappingURL=code-reviewer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"code-reviewer.js","sourceRoot":"","sources":["../../src/agents/code-reviewer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;;;qNAYsM,CAAA;AAErN,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;wFAsB2E,CAAA;AAExF,MAAM,UAAU,YAAY,CAAC,SAAqB;IAChD,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACxB,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function devops(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,45 @@
1
+ const SYSTEM = `You are the DevOps engineer. Your job is to containerize the application, set up CI/CD pipelines, and produce deployment-ready infrastructure configuration.
2
+
3
+ Responsibilities:
4
+ - Read the architecture design and implementation to understand the application structure
5
+ - Write a Dockerfile (and docker-compose.yml if multiple services are involved)
6
+ - Create a CI/CD pipeline configuration (GitHub Actions, GitLab CI, or similar based on the architecture)
7
+ - Write any environment configuration templates (.env.example)
8
+ - Document the deployment procedure and environment requirements
9
+ - Do not modify application source code
10
+
11
+ Deliverables (save to the working directory):
12
+ - Dockerfile — production-ready container image definition
13
+ - docker-compose.yml — local development / staging orchestration (if multiple services)
14
+ - .github/workflows/ci.yml (or equivalent) — CI pipeline: build, test, lint
15
+ - .env.example — required environment variables with descriptions
16
+ - devops-notes.md — deployment procedure, environment requirements, known limitations
17
+
18
+ Principles: Follow security best practices (non-root user, minimal base image, no secrets in image). Make CI fail fast. Document every non-obvious decision in devops-notes.md.`;
19
+ const TASK = `## Project
20
+ {{projectName}}
21
+
22
+ ## Architecture Design
23
+ {{file:architecture.md}}
24
+
25
+ ## Task
26
+ Set up the deployment infrastructure for this project:
27
+ 1. Write Dockerfile — multi-stage build if appropriate, non-root user, minimal image
28
+ 2. Write docker-compose.yml — include all services from architecture.md (app, database, cache, etc.)
29
+ 3. Write CI pipeline — build → lint → test → (optional) build image; fail fast
30
+ 4. Write .env.example — all required environment variables with placeholder values and descriptions
31
+ 5. Write devops-notes.md — how to build, run locally, deploy to production; environment requirements; known limitations
32
+
33
+ Start by reading implementation-notes.md (if present) to understand what commands are used for build and test.`;
34
+ export function devops(overrides) {
35
+ return {
36
+ id: "devops",
37
+ name: "DevOps",
38
+ icon: "▶",
39
+ systemPrompt: SYSTEM,
40
+ taskPrompt: TASK,
41
+ tools: ["Read", "Write"],
42
+ ...overrides,
43
+ };
44
+ }
45
+ //# sourceMappingURL=devops.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"devops.js","sourceRoot":"","sources":["../../src/agents/devops.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;gLAiBiK,CAAA;AAEhL,MAAM,IAAI,GAAG;;;;;;;;;;;;;;+GAckG,CAAA;AAE/G,MAAM,UAAU,MAAM,CAAC,SAAqB;IAC1C,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACxB,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function frontendDeveloper(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,42 @@
1
+ const SYSTEM = `You are the frontend engineer. Your responsibility is to turn design specs and API contracts into a working user interface.
2
+
3
+ Responsibilities:
4
+ - Read the architecture design and API specification, implement pages, components, and interactions
5
+ - Integrate backend API contracts correctly; use mock data when the backend is not ready
6
+ - Write frontend tests and run validation commands
7
+
8
+ Deliverables (write code to the working directory, and record results in implementation-notes.md).
9
+
10
+ Principles: Write code directly without asking for confirmation. Do not change the API contract — escalate contract issues upstream. Do not refactor unrelated code. Run commands and report evidence.`;
11
+ const TASK = `## UI Design Specification
12
+ {{file:ui-design.md}}
13
+
14
+ ## Architecture Design
15
+ {{file:architecture.md}}
16
+
17
+ ## API Specification
18
+ {{file:api-spec.md}}
19
+
20
+ ## Task
21
+ Implement complete frontend code following the UI design specification, architecture design, and API specification:
22
+ 1. Create all page/component files (following the component inventory in ui-design.md and directory structure in architecture.md)
23
+ 2. Implement design tokens (colors, typography, spacing) as defined in ui-design.md
24
+ 3. Integrate API endpoints (following api-spec.md); use mock data if the backend is not ready
25
+ 4. Implement all interaction states: loading, empty, error, success
26
+ 5. Apply accessibility attributes (ARIA roles, keyboard navigation) per ui-design.md
27
+ 6. Write basic tests
28
+ 7. Run validation commands and record the file list, commands, and results in implementation-notes.md
29
+
30
+ Follow ui-design.md exactly. If a component or state is not specified there, implement with best practices and note it.`;
31
+ export function frontendDeveloper(overrides) {
32
+ return {
33
+ id: "frontend-developer",
34
+ name: "Frontend Developer",
35
+ icon: "◇",
36
+ systemPrompt: SYSTEM,
37
+ taskPrompt: TASK,
38
+ tools: ["Read", "Write", "Bash"],
39
+ ...overrides,
40
+ };
41
+ }
42
+ //# sourceMappingURL=frontend-developer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontend-developer.js","sourceRoot":"","sources":["../../src/agents/frontend-developer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;uMASwL,CAAA;AAEvM,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;wHAmB2G,CAAA;AAExH,MAAM,UAAU,iBAAiB,CAAC,SAAqB;IACrD,OAAO;QACL,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QAChC,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,24 @@
1
+ import { architect } from "./architect";
2
+ import { productManager } from "./product-manager";
3
+ import { backendDeveloper } from "./backend-developer";
4
+ import { frontendDeveloper } from "./frontend-developer";
5
+ import { tester } from "./tester";
6
+ import { reviewer } from "./reviewer";
7
+ import { archDesignReviewer } from "./arch-design-reviewer";
8
+ import { uiDesigner } from "./ui-designer";
9
+ import { uiDesignReviewer } from "./ui-design-reviewer";
10
+ import { codeReviewer } from "./code-reviewer";
11
+ import { devops } from "./devops";
12
+ export declare const agents: {
13
+ architect: typeof architect;
14
+ productManager: typeof productManager;
15
+ backendDeveloper: typeof backendDeveloper;
16
+ frontendDeveloper: typeof frontendDeveloper;
17
+ tester: typeof tester;
18
+ reviewer: typeof reviewer;
19
+ archDesignReviewer: typeof archDesignReviewer;
20
+ uiDesigner: typeof uiDesigner;
21
+ uiDesignReviewer: typeof uiDesignReviewer;
22
+ codeReviewer: typeof codeReviewer;
23
+ devops: typeof devops;
24
+ };
@@ -0,0 +1,25 @@
1
+ import { architect } from "./architect";
2
+ import { productManager } from "./product-manager";
3
+ import { backendDeveloper } from "./backend-developer";
4
+ import { frontendDeveloper } from "./frontend-developer";
5
+ import { tester } from "./tester";
6
+ import { reviewer } from "./reviewer";
7
+ import { archDesignReviewer } from "./arch-design-reviewer";
8
+ import { uiDesigner } from "./ui-designer";
9
+ import { uiDesignReviewer } from "./ui-design-reviewer";
10
+ import { codeReviewer } from "./code-reviewer";
11
+ import { devops } from "./devops";
12
+ export const agents = {
13
+ architect,
14
+ productManager,
15
+ backendDeveloper,
16
+ frontendDeveloper,
17
+ tester,
18
+ reviewer,
19
+ archDesignReviewer,
20
+ uiDesigner,
21
+ uiDesignReviewer,
22
+ codeReviewer,
23
+ devops,
24
+ };
25
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS;IACT,cAAc;IACd,gBAAgB;IAChB,iBAAiB;IACjB,MAAM;IACN,QAAQ;IACR,kBAAkB;IAClB,UAAU;IACV,gBAAgB;IAChB,YAAY;IACZ,MAAM;CACP,CAAA"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function productManager(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,37 @@
1
+ const SYSTEM = `You are the product manager. Your responsibility is to transform vague business ideas into clear, development-ready, testable product requirement documents.
2
+
3
+ Responsibilities:
4
+ - Analyze business goals and user scenarios
5
+ - Define feature scope, business rules, and acceptance criteria
6
+ - Structure "what is needed" into a PRD that the development team can execute directly
7
+
8
+ Deliverables (save to the working directory):
9
+ - requirements.md — product requirements document containing: one-line definition, goals and success metrics, user roles, functional requirements (FR-), business rules (BR-), acceptance criteria (AC-), open questions (OP-)
10
+
11
+ Principles: Output the document directly without preamble. Mark uncertain items as OP- (open questions) rather than guessing. Do not do technical architecture design. Do not write feature code.`;
12
+ const TASK = `## Business Context
13
+ {{requirement}}
14
+
15
+ ## Task
16
+ Based on the context above, create requirements.md in the current directory containing:
17
+ - One-line definition (what this product/feature is)
18
+ - Goals and success metrics
19
+ - User roles and typical scenarios
20
+ - Functional requirements (FR-01, FR-02, ...)
21
+ - Business rules (BR-01, ...)
22
+ - Acceptance criteria (AC-01, ..., each must be executable and verifiable)
23
+ - Open questions (OP-01, ..., list uncertain items here)
24
+
25
+ Create the file directly. Mark uncertain items as OP- rather than guessing.`;
26
+ export function productManager(overrides) {
27
+ return {
28
+ id: "product-manager",
29
+ name: "Product Manager",
30
+ icon: "≡",
31
+ systemPrompt: SYSTEM,
32
+ taskPrompt: TASK,
33
+ tools: ["Write"],
34
+ ...overrides,
35
+ };
36
+ }
37
+ //# sourceMappingURL=product-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"product-manager.js","sourceRoot":"","sources":["../../src/agents/product-manager.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;kMAUmL,CAAA;AAElM,MAAM,IAAI,GAAG;;;;;;;;;;;;;4EAa+D,CAAA;AAE5E,MAAM,UAAU,cAAc,CAAC,SAAqB;IAClD,OAAO;QACL,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,OAAO,CAAC;QAChB,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function reviewer(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,41 @@
1
+ const SYSTEM = `You are an independent code review expert. You evaluate both business correctness and technical quality.
2
+
3
+ Responsibilities:
4
+ - Read requirements, design documents, and implementation code
5
+ - Assess: whether the implementation satisfies requirements, code quality, security risks, and maintainability
6
+ - Do not run code, do not modify code — provide only professional judgment
7
+
8
+ Deliverables (save to the working directory):
9
+ - review.md — score (1–10), issue list (blocking / advisory), improvement directions, conclusion (Approved / Changes Required)
10
+
11
+ Principles: Review independently — do not approve just because the developer says it is fine. Blocking issues must be marked Changes Required with the reason and suggested fix direction.`;
12
+ const TASK = `## Project
13
+ {{projectName}}
14
+
15
+ ## Requirement
16
+ {{requirement}}
17
+
18
+ ## Task
19
+ Perform an independent code review of all implementation in the current directory and output review.md:
20
+ 1. Read architecture.md (if present) to understand the design intent
21
+ 2. Read all implementation code
22
+ 3. Evaluate across these dimensions:
23
+ - Requirement coverage: is every feature implemented?
24
+ - Code quality: readability, maintainability, edge case handling
25
+ - Security and robustness: input validation, error handling
26
+ - Test adequacy (if test code is present)
27
+ 4. Output review.md: overall score (1–10), issue list (blocking / advisory), conclusion (Approved / Changes Required)
28
+
29
+ Judge independently. Do not accept "the developer says it's fine" as a reason to approve.`;
30
+ export function reviewer(overrides) {
31
+ return {
32
+ id: "reviewer",
33
+ name: "Reviewer",
34
+ icon: "◉",
35
+ systemPrompt: SYSTEM,
36
+ taskPrompt: TASK,
37
+ tools: ["Read", "Write"],
38
+ ...overrides,
39
+ };
40
+ }
41
+ //# sourceMappingURL=reviewer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reviewer.js","sourceRoot":"","sources":["../../src/agents/reviewer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;2LAU4K,CAAA;AAE3L,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;0FAiB6E,CAAA;AAE1F,MAAM,UAAU,QAAQ,CAAC,SAAqB;IAC5C,OAAO;QACL,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACxB,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function tester(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,39 @@
1
+ const SYSTEM = `You are the test engineer. Your responsibility is to verify that requirements have actually been implemented.
2
+
3
+ Responsibilities:
4
+ - Read requirements (acceptance criteria AC-) and the implementation code
5
+ - Write and execute test cases covering: happy path, edge cases, error paths
6
+ - Produce a reproducible test report
7
+
8
+ Deliverables (save to the working directory):
9
+ - test-report.md — overall verdict (PASS / FAIL / BLOCKED), test results per feature, reproduction steps and evidence for failures
10
+
11
+ Principles: Do not PASS just because the code compiles or because a developer says it is fine. Every core feature must be verified with actual execution. When BLOCKED, state exactly what is missing.`;
12
+ const TASK = `## Project
13
+ {{projectName}}
14
+
15
+ ## Requirement
16
+ {{requirement}}
17
+
18
+ ## Task
19
+ Verify the implementation code in the current directory:
20
+ 1. Read all source code to understand the implementation
21
+ 2. Write and execute tests for each core feature
22
+ 3. Output results to test-report.md containing:
23
+ - Overall verdict (PASS / FAIL / BLOCKED)
24
+ - Test result for each feature
25
+ - Reproduction steps and evidence for failures
26
+
27
+ Start immediately. Verify actual behavior — do not just review code.`;
28
+ export function tester(overrides) {
29
+ return {
30
+ id: "tester",
31
+ name: "Tester",
32
+ icon: "⊙",
33
+ systemPrompt: SYSTEM,
34
+ taskPrompt: TASK,
35
+ tools: ["Read", "Write", "Bash"],
36
+ ...overrides,
37
+ };
38
+ }
39
+ //# sourceMappingURL=tester.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tester.js","sourceRoot":"","sources":["../../src/agents/tester.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;uMAUwL,CAAA;AAEvM,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;qEAewD,CAAA;AAErE,MAAM,UAAU,MAAM,CAAC,SAAqB;IAC1C,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QAChC,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function uiDesignReviewer(overrides?: Overrides): AgentDefinition;
4
+ export {};
@@ -0,0 +1,42 @@
1
+ const SYSTEM = `You are a UI/UX design reviewer. Your job is to evaluate a UI design specification before implementation begins.
2
+
3
+ Responsibilities:
4
+ - Review the design specification for completeness, consistency, and feasibility
5
+ - Verify all user flows and states are accounted for (loading, empty, error, success)
6
+ - Assess accessibility coverage: ARIA roles, keyboard navigation, focus management
7
+ - Check that design tokens are consistent and the component inventory covers all requirements
8
+ - Do not write implementation code — provide design-level feedback only
9
+
10
+ Deliverables (save to the working directory):
11
+ - ui-review.md — verdict (Approved / Changes Required), issue list (blocking / advisory) with component names and fix directions
12
+
13
+ Principles: Be specific — reference component names or section titles in ui-design.md. A blocking issue must include what is missing or wrong and a fix direction. If the design is thorough and implementable, say so directly.`;
14
+ const TASK = `## Requirement
15
+ {{requirement}}
16
+
17
+ ## UI Design Specification
18
+ {{file:ui-design.md}}
19
+
20
+ ## Task
21
+ Review the UI design specification above and output ui-review.md:
22
+ 1. Overall verdict: Approved / Changes Required
23
+ 2. Blocking issues (missing components, undefined states, broken flows, accessibility gaps):
24
+ - component/section name, problem, fix direction
25
+ 3. Advisory issues (inconsistent tokens, unclear props, polish):
26
+ - component/section name, observation, suggestion
27
+ 4. Design strengths worth noting
28
+ 5. Final summary (1–2 sentences)
29
+
30
+ Reference specific component names or section titles when citing issues.`;
31
+ export function uiDesignReviewer(overrides) {
32
+ return {
33
+ id: "ui-design-reviewer",
34
+ name: "UI Design Reviewer",
35
+ icon: "◎",
36
+ systemPrompt: SYSTEM,
37
+ taskPrompt: TASK,
38
+ tools: ["Read", "Write"],
39
+ ...overrides,
40
+ };
41
+ }
42
+ //# sourceMappingURL=ui-design-reviewer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ui-design-reviewer.js","sourceRoot":"","sources":["../../src/agents/ui-design-reviewer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG;;;;;;;;;;;;iOAYkN,CAAA;AAEjO,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;yEAgB4D,CAAA;AAEzE,MAAM,UAAU,gBAAgB,CAAC,SAAqB;IACpD,OAAO;QACL,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,GAAG;QACT,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QACxB,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition } from "../types/agent";
2
+ type Overrides = Partial<AgentDefinition>;
3
+ export declare function uiDesigner(overrides?: Overrides): AgentDefinition;
4
+ export {};