sdlc-workflow 1.0.6 → 1.0.8
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 +10 -5
- package/bin/cli.js +137 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -64,11 +64,16 @@ docs/sdlc/
|
|
|
64
64
|
│ │ └── README.md
|
|
65
65
|
│ └── senior-qe/ # Senior QE 10+ yrs: write automation tests
|
|
66
66
|
│ └── README.md
|
|
67
|
-
├── dev/ # Dev team (
|
|
68
|
-
│ ├──
|
|
69
|
-
│
|
|
70
|
-
│
|
|
71
|
-
│
|
|
67
|
+
├── dev/ # Dev team (all Senior 10+ yrs; roles vary by project)
|
|
68
|
+
│ ├── implementation-roles.template.md
|
|
69
|
+
│ ├── tech-lead/ # Tech Lead 15+ yrs
|
|
70
|
+
│ ├── senior-developer/ # Senior Dev 10+ yrs (generic)
|
|
71
|
+
│ ├── frontend/ # Senior Frontend 10+ yrs — Web UI
|
|
72
|
+
│ ├── backend/ # Senior Backend 10+ yrs
|
|
73
|
+
│ ├── mobile/ # Senior Mobile 10+ yrs
|
|
74
|
+
│ ├── embedded/ # Senior Embedded 10+ yrs — firmware, IoT
|
|
75
|
+
│ ├── data-ml/ # Senior Data/ML 10+ yrs
|
|
76
|
+
│ └── platform/ # Senior Platform 10+ yrs — CI/CD, infra
|
|
72
77
|
├── agents/ # Sub-agent specs (each role = sub-agent)
|
|
73
78
|
│ └── README.md
|
|
74
79
|
└── deploy/ # After completion → Docker Compose + K8s
|
package/bin/cli.js
CHANGED
|
@@ -15,10 +15,22 @@ async function main() {
|
|
|
15
15
|
const args = process.argv.slice(2);
|
|
16
16
|
const command = args[0] || "init";
|
|
17
17
|
|
|
18
|
+
if (command === "version" || command === "--version" || command === "-v") {
|
|
19
|
+
const pkg = JSON.parse(await readFile(join(PKG_ROOT, "package.json"), "utf8"));
|
|
20
|
+
console.log(pkg.version);
|
|
21
|
+
process.exit(0);
|
|
22
|
+
}
|
|
23
|
+
|
|
18
24
|
if (command !== "init") {
|
|
19
|
-
console.log("Usage: npx sdlc-workflow
|
|
20
|
-
console.log("
|
|
21
|
-
console.log("
|
|
25
|
+
console.log("Usage: npx sdlc-workflow <command>");
|
|
26
|
+
console.log("");
|
|
27
|
+
console.log("Commands:");
|
|
28
|
+
console.log(" init Scaffold SDLC docs and templates (Cursor, Claude, Antigravity, Codex)");
|
|
29
|
+
console.log(" version Print current version");
|
|
30
|
+
console.log("");
|
|
31
|
+
console.log("Examples:");
|
|
32
|
+
console.log(" npx sdlc-workflow init");
|
|
33
|
+
console.log(" npx sdlc-workflow version");
|
|
22
34
|
process.exit(1);
|
|
23
35
|
}
|
|
24
36
|
|
|
@@ -153,6 +165,12 @@ async function generateFromInline(cwd) {
|
|
|
153
165
|
join(base, "qe", "senior-qe"),
|
|
154
166
|
join(base, "dev", "tech-lead"),
|
|
155
167
|
join(base, "dev", "senior-developer"),
|
|
168
|
+
join(base, "dev", "frontend"),
|
|
169
|
+
join(base, "dev", "backend"),
|
|
170
|
+
join(base, "dev", "mobile"),
|
|
171
|
+
join(base, "dev", "embedded"),
|
|
172
|
+
join(base, "dev", "data-ml"),
|
|
173
|
+
join(base, "dev", "platform"),
|
|
156
174
|
join(base, "agents"),
|
|
157
175
|
join(base, "deploy"),
|
|
158
176
|
join(base, "deploy", "k8s"),
|
|
@@ -181,6 +199,13 @@ async function generateFromInline(cwd) {
|
|
|
181
199
|
["qe/senior-qe/README.md", QE_SENIOR_README],
|
|
182
200
|
["dev/tech-lead/README.md", DEV_TECH_LEAD_README],
|
|
183
201
|
["dev/senior-developer/README.md", DEV_SENIOR_README],
|
|
202
|
+
["dev/implementation-roles.template.md", DEV_IMPLEMENTATION_ROLES_TEMPLATE],
|
|
203
|
+
["dev/frontend/README.md", DEV_FRONTEND_README],
|
|
204
|
+
["dev/backend/README.md", DEV_BACKEND_README],
|
|
205
|
+
["dev/mobile/README.md", DEV_MOBILE_README],
|
|
206
|
+
["dev/embedded/README.md", DEV_EMBEDDED_README],
|
|
207
|
+
["dev/data-ml/README.md", DEV_DATA_ML_README],
|
|
208
|
+
["dev/platform/README.md", DEV_PLATFORM_README],
|
|
184
209
|
["agents/README.md", AGENTS_README],
|
|
185
210
|
["deploy/README.md", DEPLOY_README],
|
|
186
211
|
["deploy/docker-compose.yml.template", DOCKER_COMPOSE_TEMPLATE],
|
|
@@ -211,7 +236,7 @@ globs: docs/sdlc/**/*, **/*.md
|
|
|
211
236
|
3. **Architect** — ADRs, diagrams → docs/sdlc/architecture/
|
|
212
237
|
4. **Technical BA** — API specs, team breakdown → docs/sdlc/ba/technical/
|
|
213
238
|
5. **QE (docs)** — Test plan, test cases → docs/sdlc/qe/
|
|
214
|
-
6. **Dev** — After docs phase → **run implementation immediately**. Tech Lead
|
|
239
|
+
6. **Dev** — After docs phase → **run implementation immediately**. Tech Lead + implementation roles by project (FE, Backend, Mobile, Embedded, Data/ML, Platform) → docs/sdlc/dev/{role}/
|
|
215
240
|
7. **QE (testing)** — QE Lead (test framework, review) + Senior QE (10+ yrs, automation) → docs/sdlc/qe/{role}/
|
|
216
241
|
8. **Deploy** — Docker Compose + K8s → docs/sdlc/deploy/
|
|
217
242
|
|
|
@@ -287,9 +312,15 @@ User Request → PO → Business BA → Architect → Technical BA → QE (docs)
|
|
|
287
312
|
|
|
288
313
|
**Trigger**: After docs are done (Technical BA + QE docs). **Dev runs implementation immediately.**
|
|
289
314
|
|
|
290
|
-
**Roles**:
|
|
291
|
-
- **Tech Lead (15+ yrs)**:
|
|
292
|
-
- **Senior Developer (10+ yrs)**: Implement
|
|
315
|
+
**Roles** (vary by project — use only what applies; see \`docs/sdlc/dev/implementation-roles.template.md\`). All implementation roles are **Senior (10+ yrs)**:
|
|
316
|
+
- **Tech Lead (15+ yrs)**: Tech stack, review & merge. Docs: \`docs/sdlc/dev/tech-lead/\`
|
|
317
|
+
- **Senior Developer (10+ yrs)**: Implement per spec (generic). Docs: \`docs/sdlc/dev/senior-developer/\`
|
|
318
|
+
- **Senior Frontend (10+ yrs)**: Web UI. Docs: \`docs/sdlc/dev/frontend/\`
|
|
319
|
+
- **Senior Backend (10+ yrs)**: API, services. Docs: \`docs/sdlc/dev/backend/\`
|
|
320
|
+
- **Senior Mobile (10+ yrs)**: iOS/Android/cross-platform. Docs: \`docs/sdlc/dev/mobile/\`
|
|
321
|
+
- **Senior Embedded (10+ yrs)**: Firmware, IoT. Docs: \`docs/sdlc/dev/embedded/\`
|
|
322
|
+
- **Senior Data/ML (10+ yrs)**: ETL, models. Docs: \`docs/sdlc/dev/data-ml/\`
|
|
323
|
+
- **Senior Platform (10+ yrs)**: Infra, CI/CD. Docs: \`docs/sdlc/dev/platform/\`
|
|
293
324
|
|
|
294
325
|
**Requirements**: Unit Test coverage **≥ 90%**.
|
|
295
326
|
|
|
@@ -353,8 +384,9 @@ TC-001: [Scenario] — Precondition, Steps, Expected, Links to AC
|
|
|
353
384
|
- Senior QE (10+ yrs): write automation tests → docs/sdlc/qe/senior-qe/
|
|
354
385
|
|
|
355
386
|
## Dev Team
|
|
356
|
-
- Tech Lead (15+ yrs): tech stack,
|
|
387
|
+
- Tech Lead (15+ yrs): tech stack, review & merge → docs/sdlc/dev/tech-lead/
|
|
357
388
|
- Senior Dev (10+ yrs): implement, Unit Test ≥90% → docs/sdlc/dev/senior-developer/
|
|
389
|
+
- By project (all Senior 10+ yrs): Senior Frontend, Backend, Mobile, Embedded, Data/ML, Platform → docs/sdlc/dev/{role}/
|
|
358
390
|
|
|
359
391
|
## Sub-agents
|
|
360
392
|
Each role = sub-agent. See docs/sdlc/agents/
|
|
@@ -454,8 +486,8 @@ User Request → PO → Business BA → Architect → Technical BA → QE (docs)
|
|
|
454
486
|
- **After docs phase → Dev team runs implementation immediately** (no extra gate)
|
|
455
487
|
|
|
456
488
|
### Phase 5b: Dev Teams
|
|
457
|
-
- **Tech Lead (15+ yrs)**: Tech stack,
|
|
458
|
-
- **
|
|
489
|
+
- **Tech Lead (15+ yrs)**: Tech stack, review & merge. Output: \`docs/sdlc/dev/tech-lead/\`
|
|
490
|
+
- **Implementation roles** (all Senior 10+ yrs; use only what applies): Senior Dev, Senior Frontend, Senior Backend, Senior Mobile, Senior Embedded, Senior Data/ML, Senior Platform → \`docs/sdlc/dev/{role}/\`. See \`implementation-roles.template.md\`.
|
|
459
491
|
- **Requirement**: Unit Test coverage **≥ 90%**
|
|
460
492
|
- **Then**: QE starts testing phase
|
|
461
493
|
|
|
@@ -519,6 +551,12 @@ Every role in the SDLC runs as a **sub-agent**. Each phase is assigned to a corr
|
|
|
519
551
|
| QE (docs) | qe-docs | docs/sdlc/ba/technical/ | docs/sdlc/qe/ (test plan) |
|
|
520
552
|
| Tech Lead | tech-lead | Technical spec | Review, merge, docs/sdlc/dev/tech-lead/ |
|
|
521
553
|
| Senior Dev | senior-dev | Spec + test plan | After docs → run implementation immediately. Code, unit tests (≥90%) |
|
|
554
|
+
| Senior Frontend | frontend | UI spec, API contract | Web UI, docs/sdlc/dev/frontend/ |
|
|
555
|
+
| Senior Backend | backend | API spec, DB schema | API, services, docs/sdlc/dev/backend/ |
|
|
556
|
+
| Senior Mobile | mobile | API contract, design | App (iOS/Android), docs/sdlc/dev/mobile/ |
|
|
557
|
+
| Senior Embedded | embedded | HW/spec, interfaces | Firmware, IoT, docs/sdlc/dev/embedded/ |
|
|
558
|
+
| Senior Data/ML | data-ml | Data spec, models | ETL, models, docs/sdlc/dev/data-ml/ |
|
|
559
|
+
| Senior Platform | platform | Infra spec | CI/CD, observability, docs/sdlc/dev/platform/ |
|
|
522
560
|
| QE Lead | qe-lead | Test plan | Test framework, review, docs/sdlc/qe/qe-lead/ |
|
|
523
561
|
| Senior QE | senior-qe | Test plan + framework | Automation tests, docs/sdlc/qe/senior-qe/ |
|
|
524
562
|
| Deploy | deploy | QE sign-off | Docker Compose + K8s, docs/sdlc/deploy/ |
|
|
@@ -874,4 +912,93 @@ const DEV_SENIOR_README = `# Senior Developer (10+ years exp)
|
|
|
874
912
|
**Docs**: Implementation notes, API usage.
|
|
875
913
|
`;
|
|
876
914
|
|
|
915
|
+
const DEV_IMPLEMENTATION_ROLES_TEMPLATE = `# Implementation roles by project type
|
|
916
|
+
|
|
917
|
+
Use only the roles that apply. Remove or ignore the rest. Tech Lead is cross-cutting; add discipline roles as needed.
|
|
918
|
+
|
|
919
|
+
## By project type
|
|
920
|
+
|
|
921
|
+
| Project type | Roles to use (all Senior 10+ except Tech Lead 15+) |
|
|
922
|
+
|---------------------|----------------------------------------------------|
|
|
923
|
+
| Web / full-stack | Tech Lead, Senior Frontend, Senior Backend |
|
|
924
|
+
| Mobile | Tech Lead, Senior Mobile, Senior Backend |
|
|
925
|
+
| API / backend only | Tech Lead, Senior Backend |
|
|
926
|
+
| Library / SDK | Tech Lead, Senior Dev (or Senior Backend) |
|
|
927
|
+
| CLI / tooling | Tech Lead, Senior Dev (or Senior Backend) |
|
|
928
|
+
| Data / ML | Tech Lead, Senior Backend, Senior Data/ML |
|
|
929
|
+
| Embedded / IoT | Tech Lead, Senior Embedded (+ Senior Backend if needed) |
|
|
930
|
+
| Platform / infra | Tech Lead, Senior Platform (+ Senior Backend if needed) |
|
|
931
|
+
| Mixed | Tech Lead + any of: Senior Frontend, Backend, Mobile, Embedded, Data/ML, Platform |
|
|
932
|
+
|
|
933
|
+
## Role folders (all implementation roles are Senior 10+ yrs)
|
|
934
|
+
|
|
935
|
+
- \`tech-lead/\` — Tech Lead (15+ yrs): tech stack, review & merge (all projects)
|
|
936
|
+
- \`senior-developer/\` — Senior Developer: generic implementation
|
|
937
|
+
- \`frontend/\` — Senior Frontend: Web UI
|
|
938
|
+
- \`backend/\` — Senior Backend: API, services, DB
|
|
939
|
+
- \`mobile/\` — Senior Mobile: iOS, Android, cross-platform
|
|
940
|
+
- \`embedded/\` — Senior Embedded: firmware, IoT
|
|
941
|
+
- \`data-ml/\` — Senior Data/ML: ETL, models, analytics
|
|
942
|
+
- \`platform/\` — Senior Platform: CI/CD, infra, observability
|
|
943
|
+
`;
|
|
944
|
+
|
|
945
|
+
const DEV_FRONTEND_README = `# Senior Frontend (10+ years exp) — Web UI
|
|
946
|
+
|
|
947
|
+
**Responsibilities**:
|
|
948
|
+
- Implement web UI per design and API contract
|
|
949
|
+
- Unit Test coverage **≥ 90%**
|
|
950
|
+
- Follow Tech Lead's stack (e.g. React, Vue, Angular)
|
|
951
|
+
|
|
952
|
+
**Docs**: Component docs, integration notes.
|
|
953
|
+
`;
|
|
954
|
+
|
|
955
|
+
const DEV_BACKEND_README = `# Senior Backend (10+ years exp) — API, services
|
|
956
|
+
|
|
957
|
+
**Responsibilities**:
|
|
958
|
+
- Implement API, services, DB layer per Technical BA spec
|
|
959
|
+
- Unit Test coverage **≥ 90%**
|
|
960
|
+
- Follow Tech Lead's stack
|
|
961
|
+
|
|
962
|
+
**Docs**: API implementation notes, DB changes.
|
|
963
|
+
`;
|
|
964
|
+
|
|
965
|
+
const DEV_MOBILE_README = `# Senior Mobile (10+ years exp) — iOS / Android / cross-platform
|
|
966
|
+
|
|
967
|
+
**Responsibilities**:
|
|
968
|
+
- Implement app UI and API integration per spec
|
|
969
|
+
- Unit Test coverage **≥ 90%**
|
|
970
|
+
- Follow Tech Lead's stack (e.g. React Native, Flutter, native)
|
|
971
|
+
|
|
972
|
+
**Docs**: Screen/module docs, integration notes.
|
|
973
|
+
`;
|
|
974
|
+
|
|
975
|
+
const DEV_EMBEDDED_README = `# Senior Embedded (10+ years exp) — firmware, IoT
|
|
976
|
+
|
|
977
|
+
**Responsibilities**:
|
|
978
|
+
- Implement firmware, drivers, hardware interfaces per spec
|
|
979
|
+
- Tests as appropriate for target (unit, HW-in-loop)
|
|
980
|
+
- Follow Tech Lead's stack and safety constraints
|
|
981
|
+
|
|
982
|
+
**Docs**: Module design, interface specs.
|
|
983
|
+
`;
|
|
984
|
+
|
|
985
|
+
const DEV_DATA_ML_README = `# Senior Data/ML (10+ years exp)
|
|
986
|
+
|
|
987
|
+
**Responsibilities**:
|
|
988
|
+
- Implement ETL, models, analytics pipelines per spec
|
|
989
|
+
- Tests and validation for data and model quality
|
|
990
|
+
- Follow Tech Lead's stack (e.g. Python, Spark, ML frameworks)
|
|
991
|
+
|
|
992
|
+
**Docs**: Pipeline design, model cards.
|
|
993
|
+
`;
|
|
994
|
+
|
|
995
|
+
const DEV_PLATFORM_README = `# Senior Platform (10+ years exp) — infra, CI/CD
|
|
996
|
+
|
|
997
|
+
**Responsibilities**:
|
|
998
|
+
- Implement CI/CD, infra as code, observability per spec
|
|
999
|
+
- Follow Tech Lead's stack and security requirements
|
|
1000
|
+
|
|
1001
|
+
**Docs**: Runbooks, pipeline and infra docs.
|
|
1002
|
+
`;
|
|
1003
|
+
|
|
877
1004
|
main();
|