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.
Files changed (3) hide show
  1. package/README.md +10 -5
  2. package/bin/cli.js +137 -10
  3. 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 (per role)
68
- │ ├── tech-lead/ # Tech Lead 15+ yrs: tech stack, review & merge
69
- │ └── README.md
70
- └── senior-developer/ # Senior Dev 10+ yrs: implement, Unit Test ≥90%
71
- └── README.md
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 init");
20
- console.log(" Scaffolds SDLC docs and templates into current project.");
21
- console.log(" Installs for: Cursor, Claude, Antigravity, Codex.");
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 (review, merge) + Senior Dev (implement, ≥90% unit test) → docs/sdlc/dev/{role}/
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)**: Decide tech stack, libraries; review & merge code. Docs: \`docs/sdlc/dev/tech-lead/\`
292
- - **Senior Developer (10+ yrs)**: Implement features per spec. Docs: \`docs/sdlc/dev/senior-developer/\`
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, libraries, review & merge → docs/sdlc/dev/tech-lead/
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, libraries; review & merge. Output: \`docs/sdlc/dev/tech-lead/\`
458
- - **Senior Developer (10+ yrs)**: Implement features. Output: \`docs/sdlc/dev/senior-developer/\`
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();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdlc-workflow",
3
- "version": "1.0.6",
3
+ "version": "1.0.8",
4
4
  "description": "Scaffold SDLC workflow docs and templates for Cursor, Claude, and dev teams",
5
5
  "type": "module",
6
6
  "bin": {