@antoneeo/agentic-sdlc-skill 1.19.0 → 1.20.2

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 (14) hide show
  1. package/CHANGELOG.md +431 -332
  2. package/README.md +122 -95
  3. package/gemini-extension.json +1 -1
  4. package/package.json +50 -48
  5. package/scripts/init.js +224 -156
  6. package/scripts/lib.js +177 -168
  7. package/skills/agentic-sdlc-skill/ENFORCEMENT.md +10 -6
  8. package/skills/agentic-sdlc-skill/SKILL.md +4 -1
  9. package/skills/agentic-sdlc-skill/elicitation.md +123 -14
  10. package/skills/agentic-sdlc-skill/review.md +13 -3
  11. package/skills/agentic-sdlc-skill/routing.md +100 -0
  12. package/skills/agentic-sdlc-skill/scripts/sdlc_check.py +52 -1470
  13. package/skills/agentic-sdlc-skill/scripts/sdlc_core.py +1996 -0
  14. package/skills/agentic-sdlc-skill/templates.md +12 -0
package/README.md CHANGED
@@ -1,95 +1,122 @@
1
- # Agentic SDLC Skill for Claude Code, Gemini CLI, Google Antigravity & Codex
2
-
3
- `agentic-sdlc` is a Documentation-First SDLC protocol for AI coding agents. It supports Claude Code, Codex, Gemini CLI, Google Antigravity 2.0, Cursor/Windsurf-style project instructions, and optional devPNT governance.
4
-
5
- ## Key Features
6
-
7
- - **Risk-proportional workflow**: L1/L2/L3/Spike triage avoids heavyweight process for trivial work, with a symmetric **Write Triggers** table mapping each event to the document it produces (one event, one destination).
8
- - **Vision-guided governance**: Standalone projects use `ai_docs/vision/`; Hybrid projects use devPNT `M-VISION` as the milestone north star. The Vision names its **Actors** — the cast a feature serves, one light line each — so UX is designed for concrete roles, not an implicit "user".
9
- - **Architect pass — capabilities before files**: at L3, before listing what changes, the feature is stated as the *capabilities* it needs and each is ruled against the platform (EXISTS / INADEQUATE / MISSING); what is missing is designed as a component with its own contract, of which the feature is one consumer — never inlined into the feature's code path. A `## Component Map` in `strategic/architecture.md` is the durable inventory the pass reads, so the platform is not re-derived from source every session. On a codebase the methodology arrives in late, the map's silence is treated as **unread, not empty**: it can never ground a MISSING verdict.
10
- - **Execution disciplines**: explicit TDD (RED/GREEN/REFACTOR), systematic debugging, an L3 spec-elicitation round, and a single code-review definition wired into the workflow phases.
11
- - **Operative + comprehension guides + agent-global KB**: distil user-provided indications into source-faithful operative `GUIDE_*.md` (`source_kind: document`), and let the agent autonomously author **code-comprehension guides** (`source_kind: code`) for complex components — a source-faithful mental-model map that survives across sessions, so the next session doesn't re-derive and break the component from partial understanding. Consulted before work; shared cross-project via `~/.agentic-sdlc`.
12
- - **Opt-in subagent execution**: an approved design projects into a validated executable plan an orchestrator can drive through subagents.
13
- - **Self-activating**: a SessionStart hook emits repo-sourced orientation; a deterministic self-eval battery guards the skill's own doctrine as the release gate.
14
- - **Standalone complete**: works fully with local `ai_docs/` without requiring devPNT.
15
- - **devPNT symbiosis**: when devPNT is available, Master Plan, Action Plan, M-VISION, and governed artifacts become the authoritative planning layer, with independent fresh-context reviews of technical artifacts and diffs.
16
- - **Installed support files**: Claude, Codex, Gemini, and Google Antigravity receive the full skill folder, including `templates.md`, `architect.md`, `guides.md`, `vision.md`, `tdd.md`, `debugging.md`, `elicitation.md`, `review.md`, `dispatch.md`, `ENFORCEMENT.md`, and `scripts/sdlc_check.py`.
17
- - **Mechanical checks**: optional validator for document structure, generated feature history, stale audit areas, and protected-path gates.
18
-
19
- ## Installation
20
-
21
- ### Via npm
22
-
23
- ```bash
24
- npm install -g @antoneeo/agentic-sdlc-skill@latest
25
- agentic-sdlc-install-skill
26
- ```
27
-
28
- The installer copies `skills/agentic-sdlc-skill/` recursively into native skill locations:
29
-
30
- - Claude Code: `~/.claude/skills/agentic-sdlc/`
31
- - Codex: `~/.codex/skills/agentic-sdlc/`
32
- - Gemini CLI: `~/.gemini/skills/agentic-sdlc/`
33
- - Google Antigravity: `~/.gemini/config/skills/agentic-sdlc/` (detected distinctly from Gemini CLI; override the home with `ANTIGRAVITY_HOME`)
34
-
35
- Restart the relevant agent, or reload skills where the CLI supports it.
36
-
37
- The global package also exposes:
38
-
39
- ```bash
40
- agentic-sdlc-init
41
- ```
42
-
43
- Run it inside a project to create `ai_docs/`, Vision documents, strategic docs, audit plan, and agent protocol files (`AGENTS.md` — also the Antigravity CLI surface, `CLAUDE.md`, `GEMINI.md`, `.cursorrules`).
44
-
45
- ## Runtime Shape
46
-
47
- The actual runtime skill is the folder:
48
-
49
- ```text
50
- skills/agentic-sdlc-skill/
51
- ├── SKILL.md
52
- ├── templates.md
53
- ├── architect.md
54
- ├── guides.md
55
- ├── vision.md
56
- ├── tdd.md
57
- ├── debugging.md
58
- ├── elicitation.md
59
- ├── review.md
60
- ├── dispatch.md
61
- ├── ENFORCEMENT.md
62
- └── scripts/
63
- └── sdlc_check.py
64
- ```
65
-
66
- `SKILL.md` is the entrypoint. Supporting files are loaded or executed only when the agent needs them.
67
-
68
- ## Standalone vs Hybrid
69
-
70
- Standalone:
71
-
72
- - `ai_docs/` is the source of truth.
73
- - Vision, analysis, audit, handoff, test strategy, and feature history are maintained locally.
74
-
75
- Hybrid/devPNT:
76
-
77
- - devPNT governs `M-VISION`, Master Plan, Action Plan, and versioned artifacts.
78
- - `ai_docs/` remains useful as readable context, fallback, handoff, or shadow copy.
79
- - Divergence between user request, local Vision, and devPNT `M-VISION` must be surfaced before implementation.
80
-
81
- ## Gemini Extension Alternative
82
-
83
- You can still install this folder as a Gemini extension:
84
-
85
- ```bash
86
- gemini extensions install .
87
- ```
88
-
89
- For native Gemini Agent Skills, the npm installer now copies the skill folder into `~/.gemini/skills/agentic-sdlc/`.
90
-
91
- ## Created By
92
-
93
- Created by **Antonio Pinto** ([GitHub](https://github.com/Antoneeo)).
94
-
95
- (c) 2026 Antonio Pinto. All rights reserved.
1
+ # Agentic SDLC Skill for Claude Code, Gemini CLI, Google Antigravity & Codex
2
+
3
+ `agentic-sdlc` is a Documentation-First SDLC protocol for AI coding agents. It supports Claude Code, Codex, Gemini CLI, Google Antigravity 2.0, Cursor/Windsurf-style project instructions, and optional devPNT governance.
4
+
5
+ ## Key Features
6
+
7
+ - **Risk-proportional workflow**: L1/L2/L3/Spike triage avoids heavyweight process for trivial work, with a symmetric **Write Triggers** table mapping each event to the document it produces (one event, one destination).
8
+ - **Vision-guided governance**: Standalone projects use `ai_docs/vision/`; Hybrid projects use devPNT `M-VISION` as the milestone north star. The Vision names its **Actors** — the cast a feature serves, one light line each — so UX is designed for concrete roles, not an implicit "user".
9
+ - **Architect pass — capabilities before files**: at L3, before listing what changes, the feature is stated as the *capabilities* it needs and each is ruled against the platform (EXISTS / INADEQUATE / MISSING); what is missing is designed as a component with its own contract, of which the feature is one consumer — never inlined into the feature's code path. A `## Component Map` in `strategic/architecture.md` is the durable inventory the pass reads, so the platform is not re-derived from source every session. On a codebase the methodology arrives in late, the map's silence is treated as **unread, not empty**: it can never ground a MISSING verdict.
10
+ - **Execution disciplines**: explicit TDD (RED/GREEN/REFACTOR), systematic debugging, an L3 spec-elicitation round, and a single code-review definition wired into the workflow phases.
11
+ - **Operative + comprehension guides + agent-global KB**: distil user-provided indications into source-faithful operative `GUIDE_*.md` (`source_kind: document`), and let the agent autonomously author **code-comprehension guides** (`source_kind: code`) for complex components — a source-faithful mental-model map that survives across sessions, so the next session doesn't re-derive and break the component from partial understanding. Consulted before work; shared cross-project via `~/.agentic-sdlc`.
12
+ - **Opt-in subagent execution**: an approved design projects into a validated executable plan an orchestrator can drive through subagents.
13
+ - **Self-activating**: a SessionStart hook emits repo-sourced orientation; a deterministic self-eval battery guards the skill's own doctrine as the release gate.
14
+ - **Standalone complete**: works fully with local `ai_docs/` without requiring devPNT.
15
+ - **devPNT symbiosis**: when devPNT is available, Master Plan, Action Plan, M-VISION, and governed artifacts become the authoritative planning layer, with independent fresh-context reviews of technical artifacts and diffs.
16
+ - **Independent review, twice**: the design is reviewed before it is implemented and the diff before the work is declared done — by somebody other than its author. Three rungs of independence (fresh-context subagent > one-shot run > a declared self-pass, legal only when the first two are unavailable), capped at 3 rounds, one log line per review, and a PASS is invalid on "found nothing" — it must state where each constraint is satisfied.
17
+ - **Question discipline**: a question to the user is legal only when the agent searched first and names the search with its result, and names the decision the answer unblocks. Otherwise it proceeds on a declared assumption — same evidence duty, batched, never a stream of "shall I proceed?".
18
+ - **Installed support files**: Claude, Codex, Gemini, and Google Antigravity receive the full skill folder, including `templates.md`, `architect.md`, `guides.md`, `vision.md`, `tdd.md`, `debugging.md`, `elicitation.md`, `review.md`, `dispatch.md`, `routing.md`, `ENFORCEMENT.md`, and the validator's two files, `scripts/sdlc_check.py` + `scripts/sdlc_core.py`.
19
+ - **Mechanical checks**: optional validator for document structure, generated feature history, stale audit areas, and protected-path gates — `check`, `validate`, `index`, `stale`, `mark`, `gate`, `plan`, `orient`, `migrate`.
20
+
21
+ ## Installation
22
+
23
+ ### Via npm
24
+
25
+ ```bash
26
+ npm install -g @antoneeo/agentic-sdlc-skill@latest
27
+ ```
28
+
29
+ That is enough — the package's `postinstall` runs the installer. If your npm blocks
30
+ install scripts (`--ignore-scripts`, some CI/pnpm setups), run it by hand:
31
+
32
+ ```bash
33
+ agentic-sdlc-install-skill
34
+ ```
35
+
36
+ > The command is on your PATH only after a **global** (`-g`) install; after a local
37
+ > `npm i`, invoke it as `npx agentic-sdlc-install-skill`.
38
+
39
+ The installer copies `skills/agentic-sdlc-skill/` recursively into native skill locations:
40
+
41
+ - Claude Code: `~/.claude/skills/agentic-sdlc/`
42
+ - Codex: `~/.codex/skills/agentic-sdlc/`
43
+ - Gemini CLI: `~/.gemini/skills/agentic-sdlc/`
44
+ - Google Antigravity: `~/.gemini/config/skills/agentic-sdlc/` (detected distinctly from Gemini CLI; override the home with `ANTIGRAVITY_HOME`)
45
+
46
+ Restart the relevant agent, or reload skills where the CLI supports it.
47
+
48
+ The global package also exposes:
49
+
50
+ ```bash
51
+ agentic-sdlc-init
52
+ ```
53
+
54
+ Run it inside a project to create `ai_docs/`, Vision documents, strategic docs, audit plan, and agent protocol files (`AGENTS.md` — also the Antigravity CLI surface, `CLAUDE.md`, `GEMINI.md`, `.cursorrules`).
55
+
56
+ ## Runtime Shape
57
+
58
+ The actual runtime skill is the folder:
59
+
60
+ ```text
61
+ skills/agentic-sdlc-skill/
62
+ ├── SKILL.md
63
+ ├── templates.md
64
+ ├── architect.md
65
+ ├── guides.md
66
+ ├── vision.md
67
+ ├── tdd.md
68
+ ├── debugging.md
69
+ ├── elicitation.md
70
+ ├── review.md
71
+ ├── dispatch.md
72
+ ├── routing.md
73
+ ├── ENFORCEMENT.md
74
+ └── scripts/
75
+ ├── sdlc_check.py
76
+ └── sdlc_core.py
77
+ ```
78
+
79
+ `SKILL.md` is the entrypoint. Supporting files are loaded or executed only when the agent needs them.
80
+
81
+ The validator is **two files**: `sdlc_core.py` is the family's shared spine, `sdlc_check.py` is this lens's entry point. Copy both, or neither — the entry point is useless alone.
82
+
83
+ ## The family: three lenses, one spine
84
+
85
+ Same process, three fidelity disciplines — what the agent's assertions must be faithful to:
86
+
87
+ | Package | Faithful to | Unit of work | Own doctrine |
88
+ |---|---|---|---|
89
+ | [`@antoneeo/agentic-sdlc-skill`](https://www.npmjs.com/package/@antoneeo/agentic-sdlc-skill) | this repository's code | feature | `architect.md`, `tdd.md`, `debugging.md` |
90
+ | [`@antoneeo/kb-agentic-skill`](https://www.npmjs.com/package/@antoneeo/kb-agentic-skill) | the documents you supply | topic | `taxonomy.md`, `distillation.md`, `reconciliation.md` |
91
+ | [`@antoneeo/mkt-agentic-sdlc-skill`](https://www.npmjs.com/package/@antoneeo/mkt-agentic-sdlc-skill) | market evidence | engagement | `frameworks.md`, `research.md` |
92
+
93
+ Triage, the Vision Gate, the review gates, the guide router, question discipline and the validator spine are byte-identical across the three. Install only the one you need; when two live in the same project, `routing.md` decides which lens owns a given piece of work and any of the three validators gives the same verdict on the same tree.
94
+
95
+ ## Standalone vs Hybrid
96
+
97
+ Standalone:
98
+
99
+ - `ai_docs/` is the source of truth.
100
+ - Vision, analysis, audit, handoff, test strategy, and feature history are maintained locally.
101
+
102
+ Hybrid/devPNT:
103
+
104
+ - devPNT governs `M-VISION`, Master Plan, Action Plan, and versioned artifacts.
105
+ - `ai_docs/` remains useful as readable context, fallback, handoff, or shadow copy.
106
+ - Divergence between user request, local Vision, and devPNT `M-VISION` must be surfaced before implementation.
107
+
108
+ ## Gemini Extension Alternative
109
+
110
+ You can still install this folder as a Gemini extension:
111
+
112
+ ```bash
113
+ gemini extensions install .
114
+ ```
115
+
116
+ For native Gemini Agent Skills, the npm installer now copies the skill folder into `~/.gemini/skills/agentic-sdlc/`.
117
+
118
+ ## Created By
119
+
120
+ Created by **Antonio Pinto** ([GitHub](https://github.com/Antoneeo)).
121
+
122
+ MIT (c) 2026 Antonio Pinto.
package/gemini-extension.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-sdlc-skill",
3
- "version": "1.19.0",
3
+ "version": "1.20.2",
4
4
  "description": "Documentation-First SDLC protocol with triage, Vision governance and optional devPNT integration.",
5
5
  "author": "Antonio Pinto (https://github.com/Antoneeo)"
6
6
  }
package/package.json CHANGED
@@ -1,48 +1,50 @@
1
- {
2
- "name": "@antoneeo/agentic-sdlc-skill",
3
- "version": "1.19.0",
4
- "description": "Documentation-First SDLC protocol for Claude Code, Gemini CLI, Google Antigravity and Codex with risk triage, Vision governance, installed support files and optional devPNT integration.",
5
- "keywords": [
6
- "claude-code",
7
- "claude-skill",
8
- "gemini-cli",
9
- "skill",
10
- "sdlc",
11
- "documentation",
12
- "ai-agent"
13
- ],
14
- "author": "Antonio Pinto (https://github.com/Antoneeo)",
15
- "license": "MIT",
16
- "publishConfig": {
17
- "access": "public"
18
- },
19
- "bin": {
20
- "agentic-sdlc-init": "scripts/init.js",
21
- "agentic-sdlc-install-skill": "scripts/postinstall.js"
22
- },
23
- "scripts": {
24
- "postinstall": "node scripts/postinstall.js",
25
- "preuninstall": "node scripts/preuninstall.js"
26
- },
27
- "files": [
28
- "skills/agentic-sdlc-skill/SKILL.md",
29
- "skills/agentic-sdlc-skill/templates.md",
30
- "skills/agentic-sdlc-skill/architect.md",
31
- "skills/agentic-sdlc-skill/guides.md",
32
- "skills/agentic-sdlc-skill/vision.md",
33
- "skills/agentic-sdlc-skill/tdd.md",
34
- "skills/agentic-sdlc-skill/debugging.md",
35
- "skills/agentic-sdlc-skill/elicitation.md",
36
- "skills/agentic-sdlc-skill/review.md",
37
- "skills/agentic-sdlc-skill/dispatch.md",
38
- "skills/agentic-sdlc-skill/ENFORCEMENT.md",
39
- "skills/agentic-sdlc-skill/scripts/sdlc_check.py",
40
- "gemini-extension.json",
41
- "README.md",
42
- "CHANGELOG.md",
43
- "scripts/lib.js",
44
- "scripts/init.js",
45
- "scripts/postinstall.js",
46
- "scripts/preuninstall.js"
47
- ]
48
- }
1
+ {
2
+ "name": "@antoneeo/agentic-sdlc-skill",
3
+ "version": "1.20.2",
4
+ "description": "Documentation-First SDLC protocol for Claude Code, Gemini CLI, Google Antigravity and Codex with risk triage, Vision governance, installed support files and optional devPNT integration.",
5
+ "keywords": [
6
+ "claude-code",
7
+ "claude-skill",
8
+ "gemini-cli",
9
+ "skill",
10
+ "sdlc",
11
+ "documentation",
12
+ "ai-agent"
13
+ ],
14
+ "author": "Antonio Pinto (https://github.com/Antoneeo)",
15
+ "license": "MIT",
16
+ "publishConfig": {
17
+ "access": "public"
18
+ },
19
+ "bin": {
20
+ "agentic-sdlc-init": "scripts/init.js",
21
+ "agentic-sdlc-install-skill": "scripts/postinstall.js"
22
+ },
23
+ "scripts": {
24
+ "postinstall": "node scripts/postinstall.js",
25
+ "preuninstall": "node scripts/preuninstall.js"
26
+ },
27
+ "files": [
28
+ "skills/agentic-sdlc-skill/SKILL.md",
29
+ "skills/agentic-sdlc-skill/templates.md",
30
+ "skills/agentic-sdlc-skill/architect.md",
31
+ "skills/agentic-sdlc-skill/guides.md",
32
+ "skills/agentic-sdlc-skill/vision.md",
33
+ "skills/agentic-sdlc-skill/tdd.md",
34
+ "skills/agentic-sdlc-skill/debugging.md",
35
+ "skills/agentic-sdlc-skill/elicitation.md",
36
+ "skills/agentic-sdlc-skill/review.md",
37
+ "skills/agentic-sdlc-skill/dispatch.md",
38
+ "skills/agentic-sdlc-skill/routing.md",
39
+ "skills/agentic-sdlc-skill/ENFORCEMENT.md",
40
+ "skills/agentic-sdlc-skill/scripts/sdlc_check.py",
41
+ "skills/agentic-sdlc-skill/scripts/sdlc_core.py",
42
+ "gemini-extension.json",
43
+ "README.md",
44
+ "CHANGELOG.md",
45
+ "scripts/lib.js",
46
+ "scripts/init.js",
47
+ "scripts/postinstall.js",
48
+ "scripts/preuninstall.js"
49
+ ]
50
+ }