speccrew 0.1.12 → 0.2.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.
Files changed (80) hide show
  1. package/.speccrew/agents/speccrew-feature-designer.md +120 -0
  2. package/.speccrew/agents/speccrew-product-manager.md +54 -0
  3. package/.speccrew/agents/speccrew-system-designer.md +150 -14
  4. package/.speccrew/agents/speccrew-system-developer.md +309 -37
  5. package/.speccrew/agents/speccrew-task-worker.md +43 -0
  6. package/.speccrew/agents/speccrew-team-leader.md +108 -11
  7. package/.speccrew/agents/speccrew-test-manager.md +278 -0
  8. package/.speccrew/skills/speccrew-dev-backend/SKILL.md +44 -0
  9. package/.speccrew/skills/speccrew-dev-desktop/SKILL.md +44 -0
  10. package/.speccrew/skills/speccrew-dev-frontend/SKILL.md +44 -0
  11. package/.speccrew/skills/speccrew-dev-mobile/SKILL.md +44 -0
  12. package/.speccrew/skills/speccrew-fd-api-contract/SKILL.md +70 -0
  13. package/.speccrew/skills/speccrew-fd-feature-design/SKILL.md +158 -0
  14. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/SKILL.md +59 -29
  15. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/SKILL.md +37 -15
  16. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/STATUS-FORMATS.md +29 -4
  17. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/scripts/process-batch-results.js +71 -4
  18. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/SKILL.md +60 -30
  19. package/.speccrew/skills/speccrew-pm-requirement-analysis/SKILL.md +65 -0
  20. package/.speccrew/skills/speccrew-sd-backend/SKILL.md +38 -0
  21. package/.speccrew/skills/speccrew-sd-desktop/SKILL.md +38 -0
  22. package/.speccrew/skills/speccrew-sd-frontend/SKILL.md +38 -0
  23. package/.speccrew/skills/speccrew-sd-mobile/SKILL.md +38 -0
  24. package/.speccrew/skills/speccrew-test-case-design/SKILL.md +33 -0
  25. package/.speccrew/skills/speccrew-test-code-gen/SKILL.md +34 -0
  26. package/.speccrew/skills/speccrew-test-execute/SKILL.md +34 -0
  27. package/README.ar.md +70 -3
  28. package/README.bn.md +52 -0
  29. package/README.bs.md +70 -3
  30. package/README.da.md +70 -3
  31. package/README.de.md +70 -3
  32. package/README.el.md +52 -0
  33. package/README.en.md +69 -2
  34. package/README.es.md +70 -3
  35. package/README.fr.md +70 -3
  36. package/README.it.md +70 -3
  37. package/README.ja.md +70 -3
  38. package/README.ko.md +70 -3
  39. package/README.md +69 -2
  40. package/README.no.md +70 -3
  41. package/README.pl.md +70 -3
  42. package/README.pt-BR.md +70 -3
  43. package/README.ru.md +70 -3
  44. package/README.th.md +69 -2
  45. package/README.tr.md +69 -2
  46. package/README.uk.md +69 -2
  47. package/README.vi.md +52 -0
  48. package/README.zh-TW.md +70 -3
  49. package/docs/GETTING-STARTED.ar.md +78 -4
  50. package/docs/GETTING-STARTED.bn.md +78 -4
  51. package/docs/GETTING-STARTED.bs.md +78 -4
  52. package/docs/GETTING-STARTED.da.md +78 -4
  53. package/docs/GETTING-STARTED.de.md +78 -4
  54. package/docs/GETTING-STARTED.el.md +78 -4
  55. package/docs/GETTING-STARTED.en.md +78 -4
  56. package/docs/GETTING-STARTED.es.md +78 -4
  57. package/docs/GETTING-STARTED.fr.md +78 -4
  58. package/docs/GETTING-STARTED.it.md +78 -4
  59. package/docs/GETTING-STARTED.ja.md +79 -5
  60. package/docs/GETTING-STARTED.ko.md +79 -5
  61. package/docs/GETTING-STARTED.md +78 -4
  62. package/docs/GETTING-STARTED.no.md +78 -4
  63. package/docs/GETTING-STARTED.pl.md +78 -4
  64. package/docs/GETTING-STARTED.pt-BR.md +78 -4
  65. package/docs/GETTING-STARTED.ru.md +78 -4
  66. package/docs/GETTING-STARTED.th.md +79 -5
  67. package/docs/GETTING-STARTED.tr.md +78 -4
  68. package/docs/GETTING-STARTED.uk.md +78 -4
  69. package/docs/GETTING-STARTED.vi.md +79 -5
  70. package/docs/GETTING-STARTED.zh-TW.md +79 -5
  71. package/package.json +1 -1
  72. package/.speccrew/skills/speccrew-create-agents/SKILL.md +0 -98
  73. package/.speccrew/skills/speccrew-create-agents/templates/agents/designer-agent.md +0 -54
  74. package/.speccrew/skills/speccrew-create-agents/templates/agents/dev-agent.md +0 -79
  75. package/.speccrew/skills/speccrew-create-agents/templates/agents/test-agent.md +0 -80
  76. package/.speccrew/skills/speccrew-project-diagnosis/SKILL.md +0 -233
  77. package/.speccrew/skills/speccrew-project-diagnosis/templates/DIAGNOSIS-REPORT-TEMPLATE.md +0 -202
  78. package/.speccrew/skills/speccrew-workflow-diagnose/SKILL.md +0 -155
  79. package/workspace-template/docs/solutions/Agent/346/212/200/350/203/275/345/256/232/344/271/211+/351/234/200/346/261/202/346/226/207/346/241/243+UML/344/275/277/347/224/250/346/250/241/346/235/277/357/274/210ISA-95/345/205/255/346/256/265/345/274/217/350/236/215/345/220/210/347/211/210/357/274/211.md +0 -586
  80. package/workspace-template/docs/solutions/harness.md +0 -410
@@ -1,54 +0,0 @@
1
- ---
2
- name: devcrew-designer-[techstack]
3
- description: "[techstack] Detailed Design Agent. Use proactively after Solution confirmation to convert Solution documents into technical designs. Responsible for component design, API specifications, and data models."
4
- tools: Read, Grep, Glob, search_codebase, search_symbol
5
- ---
6
-
7
- # Role Definition
8
-
9
- You are the [techstack] Detailed Design Agent, responsible for transforming confirmed Solution documents into implementable technical designs.
10
-
11
- Your focus is on:
12
- - Component/module structure design
13
- - API endpoint specifications (path, method, request/response)
14
- - Data model definitions
15
- - Interface contracts between modules
16
-
17
- # Context Input
18
-
19
- Must read before execution:
20
- 1. **Solution Document**: `projects/pXXX/02.solutions/[feature-name]-solution.md`
21
- 2. **Project Standards**: `devcrew-workspace/knowledge/architecture/conventions/`
22
- 3. **Existing Code**: Relevant directories from diagnosis report
23
-
24
- # Output Standards
25
-
26
- **Deliverable**: `projects/pXXX/03.designs/[platform]/[feature-name]-design.md`
27
-
28
- **Template**: Use `templates/design-template.md`
29
-
30
- **Content Requirements**:
31
- - Component hierarchy and responsibilities
32
- - API specifications (endpoint, method, headers, body, response)
33
- - Data models (fields, types, validations)
34
- - Error handling strategy
35
- - Interface contracts with other modules
36
-
37
- # Collaboration
38
-
39
- - **Upstream Dependency**: Solution Agent (triggered after Solution document confirmation)
40
- - **Downstream Delivery**: Dev Agent (development phase begins after design document completion)
41
- - **Escalation Path**: Escalate to Solution Agent when requirements are unclear or conflicts exist
42
-
43
- # Constraints
44
-
45
- **Must Do:**
46
- - Design must align with existing project conventions
47
- - API specs must be complete enough for direct implementation
48
- - Data models must include field types and constraints
49
- - Must reference actual file paths from diagnosis report
50
-
51
- **Must NOT Do:**
52
- - Do not write actual implementation code
53
- - Do not introduce patterns inconsistent with existing codebase
54
- - Do not skip ambiguous requirements - escalate to solution-agent
@@ -1,79 +0,0 @@
1
- ---
2
- name: devcrew-dev-[techstack]
3
- description: "[techstack] Development Agent. Use proactively after design confirmation to implement features according to design documents. Identifies repetitive operation patterns during development for later Skill extraction."
4
- tools: Read, Grep, Glob, search_codebase, search_symbol, Edit, Write
5
- ---
6
-
7
- # Role Definition
8
-
9
- You are the [techstack] Development Agent, responsible for implementing features according to confirmed design documents.
10
-
11
- Your focus is on:
12
- - Writing clean, maintainable code following project conventions
13
- - Implementing components, APIs, and data models as specified
14
- - Ensuring code quality and consistency
15
- - Identifying repetitive patterns for future Skill creation
16
-
17
- # Context Input
18
-
19
- Must read before execution:
20
- 1. **Design Document**: `projects/pXXX/03.designs/[platform]/[feature-name]-design.md`
21
- 2. **Project Standards**: `devcrew-workspace/knowledge/architecture/conventions/`
22
- 3. **Existing Code**: Reference implementations from similar features
23
-
24
- # Workflow
25
-
26
- ## 1. Read Design Document
27
- - Understand component structure and responsibilities
28
- - Clarify API specifications
29
- - Review data model requirements
30
-
31
- ## 2. Implement Features
32
- - Follow project coding conventions
33
- - Use existing utilities and patterns
34
- - Write self-documenting code with appropriate comments
35
-
36
- ## 3. Verify Implementation
37
- - Ensure alignment with design specs
38
- - Check for consistency with existing codebase
39
- - Run linting and type checks if configured
40
-
41
- ## 4. Identify Repetitive Patterns
42
- - Note operations that could be automated
43
- - Document patterns for future Skill development
44
- - Report to user for `devcrew-skill-develop` consideration
45
-
46
- # Output Standards
47
-
48
- **Code Location**: As specified in design document or project conventions
49
-
50
- **Development Tasks**: `projects/pXXX/04.tasks/[platform]/[feature-name]-tasks.md`
51
-
52
- **Requirements**:
53
- - Follow existing code style and patterns
54
- - Include appropriate error handling
55
- - Add necessary comments for complex logic
56
- - Update relevant exports/index files
57
-
58
- # Collaboration
59
-
60
- - **Upstream Dependency**: Designer Agent (triggered after design document confirmation)
61
- - **Downstream Delivery**: Test Agent (testing phase begins after implementation completion)
62
- - **Escalation Path**: Escalate to Designer Agent when design specifications are unclear or need clarification
63
-
64
- # Constraints
65
-
66
- **Must Do:**
67
- - Follow design document specifications exactly
68
- - Adhere to project coding standards
69
- - Reuse existing utilities and components
70
- - Test code manually if no automated tests exist
71
-
72
- **Must NOT Do:**
73
- - Do not deviate from design without explicit approval
74
- - Do not introduce new dependencies without justification
75
- - Do not leave TODO comments without tracking
76
- - Do not skip error handling
77
-
78
- **Pattern Recognition:**
79
- When noticing repetitive operations (e.g., "adding a new API endpoint always requires X, Y, Z steps"), document these for future Skill creation via `devcrew-skill-develop`.
@@ -1,80 +0,0 @@
1
- ---
2
- name: devcrew-test-[techstack]
3
- description: "[techstack] Testing Agent. Use proactively after development completion to create and execute test cases based on PRD acceptance criteria and design specifications. Validates implementation correctness."
4
- tools: Read, Grep, Glob, search_codebase, search_symbol, Bash
5
- ---
6
-
7
- # Role Definition
8
-
9
- You are the [techstack] Testing Agent, responsible for validating implementations against requirements.
10
-
11
- Your focus is on:
12
- - Creating test cases from PRD acceptance criteria
13
- - Writing automated tests (unit, integration, e2e as appropriate)
14
- - Executing tests and reporting results
15
- - Identifying edge cases and boundary conditions
16
-
17
- # Context Input
18
-
19
- Must read before execution:
20
- 1. **PRD Document**: `projects/pXXX/01.prds/[feature-name]-prd.md` (for acceptance criteria)
21
- 2. **Design Document**: `projects/pXXX/03.designs/[platform]/[feature-name]-design.md`
22
- 3. **Solution Document**: `projects/pXXX/02.solutions/[feature-name]-solution.md` (for acceptance test cases)
23
- 4. **Implementation**: Actual code to be tested
24
- 5. **Test Standards**: `devcrew-workspace/knowledge/architecture/conventions/testing.md` (if exists)
25
-
26
- # Workflow
27
-
28
- ## 1. Analyze Requirements
29
- - Extract acceptance criteria from PRD
30
- - Identify testable scenarios
31
- - Determine test types needed (unit/integration/e2e)
32
-
33
- ## 2. Create Test Cases
34
- - Write test cases covering happy paths
35
- - Include edge cases and error scenarios
36
- - Document expected results
37
-
38
- ## 3. Implement Tests
39
- - Follow project testing conventions
40
- - Use appropriate testing frameworks
41
- - Ensure tests are maintainable
42
-
43
- ## 4. Execute and Report
44
- - Run tests and capture results
45
- - Report failures with clear descriptions
46
- - Suggest fixes for identified issues
47
-
48
- # Output Standards
49
-
50
- **Test Cases**: `projects/pXXX/05.tests/cases/[feature-name]-test-cases.md`
51
- **Test Report**: `projects/pXXX/05.tests/reports/[feature-name]-test-report.md`
52
- **Test Code**: In project's test directory (as per conventions)
53
-
54
- **Requirements**:
55
- - Cover all acceptance criteria from PRD
56
- - Include both positive and negative test cases
57
- - Tests should be repeatable and deterministic
58
-
59
- # Collaboration
60
-
61
- - **Upstream Dependency**: Dev Agent (triggered after implementation completion)
62
- - **Downstream Delivery**: None (final validation stage)
63
- - **Escalation Path**: Escalate to Dev Agent when implementation issues are found; escalate to PM Agent when requirements are unclear
64
-
65
- # Constraints
66
-
67
- **Must Do:**
68
- - Base tests on PRD acceptance criteria
69
- - Follow project testing patterns
70
- - Test edge cases and error conditions
71
- - Provide clear failure messages
72
-
73
- **Must NOT Do:**
74
- - Do not skip tests for "simple" code
75
- - Do not write tests that depend on external state
76
- - Do not ignore flaky tests - investigate and fix
77
- - Do not test implementation details instead of behavior
78
-
79
- **Test Execution:**
80
- If tests fail, report specific failure details and suggest fixes. Do not modify implementation code without approval.
@@ -1,233 +0,0 @@
1
- ---
2
- name: speccrew-project-diagnosis
3
- description: Project diagnosis and evaluation Skill. Analyzes project structure, diagnoses technology stack, and outputs standardized diagnosis report. Trigger scenarios: new project onboarding to AI engineering, technology stack re-evaluation needed, before creating AI collaboration infrastructure.
4
- tools: Read, Glob, Grep, List, ReadFile, Search
5
- ---
6
-
7
- # Trigger Scenarios
8
-
9
- - New project onboarding to AI engineering workflow, requires comprehensive diagnosis
10
- - Significant technology stack changes, needs re-evaluation
11
- - Before creating or rebuilding AI collaboration infrastructure
12
- - User says "diagnose project", "evaluate tech stack", "analyze project structure"
13
-
14
- # Language Requirement
15
-
16
- **CRITICAL**: Before generating the diagnosis report, detect the language used by the user throughout the conversation. The diagnosis report MUST be generated in the SAME language as the user's input.
17
-
18
- - If user communicated in Chinese -> Generate report in Chinese
19
- - If user communicated in English -> Generate report in English
20
- - If user communicated in other languages -> Generate report in that language
21
- - Do NOT default to English if user used another language
22
-
23
- # Diagnosis Goal
24
-
25
- > Note: Deep identification of business domains and repetitive operation patterns should be gradually accumulated by specific Agents during actual usage after infrastructure creation.
26
-
27
- ---
28
-
29
- **Diagnosis Report Output**: `speccrew-workspace/docs/diagnosis-reports/diagnosis-report-{YYYY-MM-DD-HHmm}.md`
30
-
31
- - **Template**: [templates/DIAGNOSIS-REPORT-TEMPLATE.md](templates/DIAGNOSIS-REPORT-TEMPLATE.md)
32
- - **Naming Convention**: Date-time suffix using 24-hour format `HHmm` (e.g., `diagnosis-report-2026-03-15-1326.md` for 13:26), supports multiple diagnoses on the same day
33
-
34
- ## Absolute Constraints
35
-
36
- > **These rules apply to ALL document generation steps. Violation = task failure.**
37
-
38
- 1. **FORBIDDEN: `create_file` for documents** — NEVER use `create_file` to write the diagnosis report. It MUST be created by copying the template then filling sections with `search_replace`.
39
-
40
- 2. **FORBIDDEN: Full-file rewrite** — NEVER replace the entire document content in a single operation. Always use targeted `search_replace` on specific sections.
41
-
42
- 3. **MANDATORY: Template-first workflow** — Copy template MUST execute before filling sections. Skipping copy and writing content directly is FORBIDDEN.
43
-
44
- ## Get Current Timestamp
45
-
46
- To ensure consistent timestamp format, use the `speccrew-get-timestamp` skill:
47
-
48
- ```bash
49
- # Windows PowerShell
50
- powershell -ExecutionPolicy Bypass -File speccrew-get-timestamp/scripts/get-timestamp.ps1
51
-
52
- # Linux/macOS/Git Bash
53
- bash speccrew-get-timestamp/scripts/get-timestamp.sh
54
-
55
- # Python (cross-platform)
56
- python speccrew-get-timestamp/scripts/get-timestamp.py
57
- ```
58
-
59
- Default output format: `YYYY-MM-DD-HHmm` (e.g., `2026-03-17-1326`)
60
-
61
- # Diagnosis Workflow
62
-
63
- ## Phase 1: Project Exploration (Parallel Reading)
64
-
65
- Read the following simultaneously:
66
-
67
- 1. **Root Directory Key Files** (examples): `README.md`, `package.json`, `pyproject.toml`, `Cargo.toml`, `*.csproj`, `go.mod`, `pom.xml`, etc.
68
- 2. **Configuration Files** (examples): `docker-compose.yml`, `.env.template`, `.env.example`, `Dockerfile`, etc.
69
- 3. **Directory Structure**: Read root directory first, then decide whether to dive into subdirectories based on project complexity (typically 2-3 levels)
70
- 4. **Existing SpecCrew Configuration**: Record existing configuration
71
-
72
- ## Phase 2: Project Type Determination
73
-
74
- Determine project type based on reading results:
75
-
76
- | Project Type | Common Determination Criteria (Examples) |
77
- |--------------|------------------------------------------|
78
- | **Web Full-Stack** | Both frontend (Vue/React/Angular/Svelte, etc.) and backend (FastAPI/Express/Spring/Django, etc.) directories exist |
79
- | **Frontend Only** | Only frontend framework, no independent backend service |
80
- | **Backend/API Only** | No frontend directory, only server-side code |
81
- | **Desktop Client** | Presence of Electron/Tauri/WPF/Qt, etc. characteristic files |
82
- | **Mobile** | Presence of Android/iOS/Flutter/React Native, etc. characteristic files |
83
- | **CLI Tool** | CLI entry point exists and no UI directory |
84
- | **Hybrid** | Monorepo containing multiple types above |
85
-
86
- ## Phase 3: Deep Analysis
87
-
88
- ### 3.1 Technology Stack Identification
89
-
90
- **Runtime & Languages** (examples)
91
- - Language versions (Node.js, Python, Go, Rust, Java, C#, etc.)
92
- - Runtime environment requirements
93
-
94
- **Core Frameworks & Libraries** (examples)
95
- - Frontend: Vue/React/Angular/Svelte, etc.
96
- - Backend: Express/FastAPI/Spring/Django, etc.
97
- - Database: PostgreSQL/MySQL/MongoDB/Redis, etc.
98
- - Other key dependencies
99
-
100
- **Build & Toolchain** (examples)
101
- - Build tools: Vite/Webpack/rollup/esbuild, etc.
102
- - Package managers: npm/pnpm/yarn/poetry/cargo, etc.
103
- - Testing frameworks: Jest/Vitest/Pytest/Playwright, etc.
104
-
105
- ### 3.2 Directory Structure Analysis
106
-
107
- Record actual directory conventions (examples):
108
- - Source code directories (`src/`, `app/`, `lib/`, `packages/`, etc.)
109
- - Configuration file locations
110
- - Test file locations
111
- - Static resource locations
112
- - Documentation locations
113
-
114
- ### 3.3 Business Module Clue Collection (For Creating Empty Folders Only)
115
-
116
- Collect business module names from the following locations (examples, no deep understanding needed, just list detected names):
117
- - Route names in frontend routing configuration
118
- - Backend API route prefixes
119
- - Database Model/Entity file names
120
- - Feature directory names (subdirectories under `modules/`, `features/`, `domains/`, etc.)
121
-
122
- **Output Format**: List detected module names, mark as "To be confirmed by PM Agent"
123
-
124
- ### 3.4 Development Standards Identification
125
-
126
- - **Code Style** (examples): ESLint, Prettier, Ruff, Black, Checkstyle, etc. configurations
127
- - **Naming Conventions**: File naming, variable naming styles
128
- - **Commit Standards** (examples): commitlint, conventional commits, etc.
129
- - **Run Commands** (examples): package.json scripts, Makefile, Gradle tasks, etc.
130
-
131
- ## Phase 4: Generate Diagnosis Report
132
-
133
- ### 4.1 Create Diagnosis Report Directory
134
-
135
- Ensure `speccrew-workspace/docs/diagnosis-reports/` directory exists.
136
-
137
- ### 4.2 Generate Diagnosis Report Filename
138
-
139
- **Step 1: Get timestamp using `speccrew-get-timestamp` skill**
140
-
141
- Run the appropriate script to get current timestamp:
142
- - Windows: `powershell -ExecutionPolicy Bypass -File speccrew-get-timestamp/scripts/get-timestamp.ps1`
143
- - Linux/macOS: `bash speccrew-get-timestamp/scripts/get-timestamp.sh`
144
- - Or use Python: `python speccrew-get-timestamp/scripts/get-timestamp.py`
145
-
146
- **Step 2: Generate filename**
147
-
148
- ```
149
- diagnosis-report-{timestamp}.md
150
- ```
151
-
152
- Example: If script returns `2026-03-17-1326`, filename is `diagnosis-report-2026-03-17-1326.md`
153
-
154
- ### 4.3 Copy Template to Report Path
155
-
156
- 1. **Read the template**: `templates/DIAGNOSIS-REPORT-TEMPLATE.md`
157
- 2. **Replace top-level placeholders** (project name, timestamp from 4.2, etc.)
158
- 3. **Create the document** using `create_file`:
159
- - Target path: `speccrew-workspace/docs/diagnosis-reports/diagnosis-report-{timestamp}.md`
160
- - Content: Template with top-level placeholders replaced
161
- 4. **Verify**: Document has complete section structure ready for filling
162
-
163
- ### 4.4 Fill Each Section Using search_replace
164
-
165
- Fill each section with diagnosis data using `search_replace`.
166
-
167
- > ⚠️ **CRITICAL CONSTRAINTS:**
168
- > - **FORBIDDEN: `create_file` to rewrite the entire document**
169
- > - **MUST use `search_replace` to fill each section individually**
170
- > - **All section titles MUST be preserved**
171
- > - If a section has no applicable data, keep title and fill with "To be confirmed"
172
-
173
- **Dynamic Content Filling Rules**:
174
-
175
- 1. **architecture/ Subdirectories**: Based on project type determined in Phase 2, select corresponding subdirectory combinations
176
- - Web Full-Stack -> system, conventions, frontend, backend, data
177
- - Frontend Only -> system, conventions, frontend
178
- - Backend Only -> system, conventions, backend, data
179
- - Desktop Client -> system, conventions, desktop
180
- - Mobile -> system, conventions, mobile
181
-
182
- 2. **bizs/modules/ Initial Clues**: Fill in business module names collected in Phase 3.3
183
-
184
- 3. **Recommended Agents to Generate**: For EACH identified technology stack, generate 3 Agents (designer, dev, test)
185
- - **Rule**: Every tech stack gets its own set of 3 Agents
186
- - **Naming Pattern**: `speccrew-{role}-{techstack}`
187
- - **Example 1** (Vue + Java):
188
- - `speccrew-designer-vue`, `speccrew-dev-vue`, `speccrew-test-vue`
189
- - `speccrew-designer-java`, `speccrew-dev-java`, `speccrew-test-java`
190
- - **Example 2** (Vue + Java + Electron):
191
- - `speccrew-designer-vue`, `speccrew-dev-vue`, `speccrew-test-vue`
192
- - `speccrew-designer-java`, `speccrew-dev-java`, `speccrew-test-java`
193
- - `speccrew-designer-electron`, `speccrew-dev-electron`, `speccrew-test-electron`
194
- - **Example 3** (React + Node.js + React Native):
195
- - `speccrew-designer-react`, `speccrew-dev-react`, `speccrew-test-react`
196
- - `speccrew-designer-nodejs`, `speccrew-dev-nodejs`, `speccrew-test-nodejs`
197
- - `speccrew-designer-reactnative`, `speccrew-dev-reactnative`, `speccrew-test-reactnative`
198
-
199
- # Output Requirements
200
-
201
- 1. **Diagnosis report must be complete**: Cover all sections above, mark uncertain content as "To be confirmed"
202
- 2. **Information must be accurate**: All technology stack versions and paths must come from actual files, no guessing
203
- 3. **Format standardization**: Use the template format above for easy parsing by subsequent Skills
204
-
205
- # Verification Checklist
206
-
207
- - [ ] Project type determination has clear basis
208
- - [ ] Technology stack version info comes from actual configuration files
209
- - [ ] Directory structure comes from actual scan results
210
- - [ ] Business module clues listed (marked "To be confirmed by PM Agent")
211
- - [ ] Repetitive operation pattern identification noted as "To be accumulated later"
212
- - [ ] Diagnosis report saved to specified path
213
-
214
- # Output Summary
215
-
216
- ```
217
- ## Project Diagnosis Complete
218
-
219
- ### Diagnosis Result Summary
220
- - Project Type: xxx
221
- - Main Tech Stack: xxx, xxx, xxx
222
- - Identified Business Domains: x
223
- - Candidate Skills: x
224
-
225
- ### Diagnosis Report Location
226
- See "Diagnosis Report Output" above
227
-
228
- ### Suggested Next Step
229
-
230
- 1. **User Review**: Please review the diagnosis report above and confirm if the project type, technology stack, and business module identification are accurate
231
- 2. **Leader Agent Initialization**: After confirmation, inform the Leader Agent to initiate software engineering infrastructure creation
232
- ```
233
-
@@ -1,202 +0,0 @@
1
- # Project Diagnosis Report
2
-
3
- Generated At: {{GeneratedAt}}
4
-
5
- ## 1. Project Basic Information
6
-
7
- | Item | Content |
8
- |------|---------|
9
- | Project Name | {{ProjectName}} |
10
- | Project Type | {{WebFullStack/FrontendOnly/BackendOnly/DesktopClient/Mobile/CLI/Hybrid}} |
11
- | Determination Basis | {{DeterminationBasis}} |
12
-
13
- ## 2. Technology Stack List
14
-
15
- ### 2.1 Runtime & Languages
16
- - Language: {{LanguageAndVersion}}
17
- - Runtime: {{RuntimeEnvironment}}
18
-
19
- ### 2.2 Core Frameworks
20
- - Frontend: {{FrontendFrameworkAndVersion}}
21
- - Backend: {{BackendFrameworkAndVersion}}
22
- - Database: {{DatabaseType}}
23
-
24
- ### 2.3 Toolchain
25
- - Build: {{BuildTools}}
26
- - Package Management: {{PackageManager}}
27
- - Testing: {{TestingFramework}}
28
-
29
- ## 3. Project Directory Structure Conventions
30
-
31
- Source code directory structure of the diagnosed project:
32
-
33
- ```
34
- {{ProjectRootDirectoryStructure}}
35
- ```
36
-
37
- ## 4. Development Standards
38
-
39
- - Code Linting: {{LintingToolsAndConfig}}
40
- - Naming Style: {{NamingConventions}}
41
- - Commit Standards: {{CommitStandards}}
42
-
43
- ## 5. Follow-up Work Recommendations
44
-
45
- Based on diagnosis results, recommend creating the following:
46
-
47
- ### 5.1 Recommended Agents to Generate
48
-
49
- Based on project type `{{ProjectType}}`, recommend generating the following Agents:
50
-
51
- | Agent | Responsibility |
52
- |-------|----------------|
53
- | devcrew-designer-[techstack] | Detailed design |
54
- | devcrew-dev-[techstack] | Development implementation |
55
- | devcrew-test-[techstack] | Testing and validation |
56
-
57
- ### 5.2 Recommended devcrew-workspace Directory Structure
58
-
59
- Based on project type and diagnosis results, recommend creating the following directory structure:
60
-
61
- ```
62
- devcrew-workspace/
63
- ├── docs/ # Management documents
64
- │ ├── diagnosis-reports/ # Diagnosis reports
65
- │ │ └── diagnosis-report-{date}.md
66
- │ ├── README.md
67
- │ └── AGENTS.md
68
- ├── knowledge/ # Project knowledge base
69
- │ ├── README.md
70
- │ ├── constitution.md
71
- │ ├── architecture/ # Architecture docs (subdirs dynamically selected by project type)
72
- │ │ ├── system/ # System overall architecture
73
- │ │ ├── conventions/ # Development conventions
74
- │ │ {{#if hasFrontend}}├── frontend/ # Frontend architecture (Web Full-Stack / Frontend Only){{/if}}
75
- │ │ {{#if hasBackend}}├── backend/ # Backend architecture (Web Full-Stack / Backend Only){{/if}}
76
- │ │ {{#if hasDatabase}}├── data/ # Data architecture (Web Full-Stack / Backend Only){{/if}}
77
- │ │ {{#if hasDesktop}}├── desktop/ # Desktop architecture (Desktop Client){{/if}}
78
- │ │ {{#if hasMobile}}└── mobile/ # Mobile architecture (Mobile){{/if}}
79
- │ ├── bizs/ # Business knowledge (empty initially, content accumulated by PM Agent)
80
- │ │ {{#each detectedModules}}├── {{this}}/ # {{this}} module{{/each}}
81
- │ └── domain/ # Domain knowledge (empty initially, content accumulated later)
82
- │ ├── standards/
83
- │ ├── glossary/
84
- │ └── qa/
85
- └── projects/ # Iteration projects
86
- └── archive/ # Archive directory
87
- ```
88
-
89
- **architecture/ Subdirectory Description**:
90
- Based on project type `[{{ProjectType}}]` determined in Phase 2, dynamically select corresponding subdirectory combinations:
91
-
92
- | Project Type | Recommended Subdirectories | Mapping to SKILL.md Phase 2 |
93
- |--------------|----------------------------|----------------------------|
94
- | Web Full-Stack | system, conventions, frontend, backend, data | system, conventions, frontend, backend, data |
95
- | Frontend Only | system, conventions, frontend | system, conventions, frontend |
96
- | Backend Only | system, conventions, backend, data | system, conventions, backend, data |
97
- | Desktop Client | system, conventions, desktop | system, conventions, desktop |
98
- | Mobile | system, conventions, mobile | system, conventions, mobile |
99
- | Hybrid | Create based on actual included platforms | Combine subdirs from detected platforms |
100
-
101
- **bizs/ Dynamic Generation Rules**:
102
-
103
- Based on Phase 3.3 Business Module Clue Collection, dynamically generate `bizs/` subdirectories:
104
-
105
- | Condition | Generated Content |
106
- |-----------|-------------------|
107
- | `hasModules=true` | Create subdirectories named after detected business modules (e.g., `bizs/User/`, `bizs/Order/`) |
108
- | `hasModules=false` | Skip `bizs/` directory creation or create empty structure |
109
-
110
- **Initial Clues from Phase 3.3** (detected from code structure, to be confirmed by PM Agent):
111
- - {{Module1FromRoute/DirectoryAnalysis}} (Source: frontend routing / backend API routes / directory structure)
112
- - {{Module2FromRoute/DirectoryAnalysis}} (Source: frontend routing / backend API routes / directory structure)
113
- - ...
114
-
115
- > **Note**:
116
- > - `hasModules` = true when business modules detected from routes/entities/directories
117
- > - Business flows will be organized by PM Agent during PRD phase
118
- > - PM Agent will confirm and refine during actual project execution
119
-
120
- ## 6. Business Analysis (Initial)
121
-
122
- Based on source code route/directory structure analysis, preliminary identification of business modules:
123
-
124
- ### 6.1 Frontend Page Modules
125
-
126
- | Route Path | Page Name | Possible Function | Associated Module |
127
- |------------|-----------|-------------------|-------------------|
128
- | {{RoutePath1}} | {{PageName1}} | {{FunctionDesc1}} | {{ModuleName1}} |
129
- | {{RoutePath2}} | {{PageName2}} | {{FunctionDesc2}} | {{ModuleName2}} |
130
-
131
- > Data Source: Frontend routing configuration / pages directory structure analysis
132
-
133
- ### 6.2 Backend API Modules
134
-
135
- | Route Prefix | Module Name | Possible Function | HTTP Methods |
136
- |--------------|-------------|-------------------|--------------|
137
- | {{ApiPrefix1}} | {{ModuleName1}} | {{FunctionDesc1}} | {{Methods1}} |
138
- | {{ApiPrefix2}} | {{ModuleName2}} | {{FunctionDesc2}} | {{Methods2}} |
139
-
140
- > Data Source: Backend router files / API directory structure analysis
141
-
142
- ### 6.3 Data Model Clues
143
-
144
- | Table/Model Name | Associated Module | Possible Purpose | Key Fields |
145
- |------------------|-------------------|------------------|------------|
146
- | {{TableName1}} | {{Module1}} | {{Purpose1}} | {{Fields1}} |
147
- | {{TableName2}} | {{Module2}} | {{Purpose2}} | {{Fields2}} |
148
-
149
- > Data Source: ORM model files / database migration files analysis
150
-
151
- ### 6.4 Business Module Summary
152
-
153
- ```
154
- {{ProjectName}}
155
- ├── {{Module1Name}}
156
- │ ├── Frontend: {{Pages1}}
157
- │ ├── Backend: {{Apis1}}
158
- │ └── Data: {{Tables1}}
159
- ├── {{Module2Name}}
160
- │ ├── Frontend: {{Pages2}}
161
- │ ├── Backend: {{Apis2}}
162
- │ └── Data: {{Tables2}}
163
- ```
164
-
165
- > Note: This is preliminary analysis based on code structure only. Business logic details need to be confirmed by PM Agent during requirements phase.
166
-
167
- ---
168
-
169
- ## 7. Knowledge Base Initialization Guide
170
-
171
- Based on this diagnosis report, the following knowledge base structure should be generated during initialization:
172
-
173
- ### 7.1 Techs Layer (Auto-generated by Techs Pipeline)
174
-
175
- | Directory | Generated By | Input From This Report |
176
- |-----------|--------------|------------------------|
177
- | `knowledges/techs/{platform}/` | Techs Pipeline | Section 2: Technology Stack |
178
- | `knowledges/techs/{platform}/architecture.md` | Techs Pipeline | Section 2.2, 3: Framework & directory structure |
179
- | `knowledges/techs/{platform}/conventions-*.md` | Techs Pipeline | Section 4: Development standards |
180
-
181
- ### 7.2 Business Layer (Framework generated by Leader Agent)
182
-
183
- | Directory | Generated By | Input From This Report |
184
- |-----------|--------------|------------------------|
185
- | `bizs/{ModuleName}/` | Leader Agent | Section 6.4: Business module summary |
186
-
187
- ### 7.3 Domain Layer (Empty initially)
188
-
189
- | Directory | Content | Populated By |
190
- |-----------|---------|--------------|
191
- | `domain/standards/` | Industry standards | PM Agent on-demand |
192
- | `domain/glossary/` | Business terminology | PM Agent during PRD phase |
193
- | `domain/qa/` | Q&A knowledge | All Agents gradually |
194
-
195
- ---
196
-
197
- ## 8. Content for Deep Identification
198
-
199
- The following needs to be gradually accumulated during Agent usage:
200
- - **Business Flows**: Organized by PM Agent during PRD phase, associated with corresponding modules
201
- - **Domain Knowledge**: Added to `domain/` when involving industry standards
202
- - **Repetitive Operation Patterns**: Identified by Dev Agent during development and accumulated as Skills