@daochild/agents-config 1.2.0 → 2.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.
- package/.agents/skills/security-audit/AI-AND-LLM.md +83 -0
- package/.agents/skills/security-audit/ATTACK-CLASSES.md +130 -0
- package/.agents/skills/security-audit/CLIENT-SIDE.md +83 -0
- package/.agents/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
- package/.agents/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
- package/.agents/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
- package/.agents/skills/security-audit/HUNTING.md +251 -0
- package/.agents/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
- package/.agents/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
- package/.agents/skills/security-audit/RECONNAISSANCE.md +156 -0
- package/.agents/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
- package/.agents/skills/security-audit/SKILL.md +192 -0
- package/.agents/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
- package/.agents/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
- package/.agents/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
- package/.agents/skills/security-audit/report-schema.json +461 -0
- package/.agents/skills/security-audit/validate-coverage-ledger.cjs +872 -0
- package/.agents/skills/security-audit/validate-coverage-ledger.test.cjs +740 -0
- package/.agents/skills/security-audit/validate-findings.cjs +773 -0
- package/.agents/skills/security-audit/validate-findings.test.cjs +652 -0
- package/.aiignore +2 -0
- package/.github/copilot-instructions.md +18 -0
- package/AGENTS.md +39 -67
- package/ARCHITECTURE.md +37 -52
- package/CLAUDE.md +1 -0
- package/CONTRIBUTING.md +24 -24
- package/README.md +75 -3
- package/SECURITY.md +8 -0
- package/docs/BUSINESS_LOGIC.md +7 -1
- package/docs/IMPLEMENTATION.md +37 -13
- package/docs/adr/0003-document-external-skill.md +29 -0
- package/docs/stories/harness-engineering-assumptions.md +44 -0
- package/docs/stories/harness-engineering-implementation-plan.md +151 -0
- package/instructions/agent/docs.md +17 -0
- package/instructions/agent/harness-orchestrator.md +60 -0
- package/instructions/agent/harness-verifier.md +30 -0
- package/{.agents/agents → instructions/agent}/sdlc-orchestrator.md +8 -0
- package/instructions/command/harness.md +13 -0
- package/instructions/rules/harness-engineering.md +19 -0
- package/{.claude → instructions}/rules/sdlc-gates.md +1 -1
- package/instructions/skills/harness-engineering/SKILL.md +76 -0
- package/opencode.json +77 -19
- package/package.json +16 -9
- package/scripts/postinstall.js +1 -1
- package/scripts/sdlc-session-check.js +526 -0
- package/skills-lock.json +11 -0
- package/.agents/agents/.gitkeep +0 -0
- package/.agents/commands/.gitkeep +0 -0
- package/.agents/rules/.gitkeep +0 -0
- package/.agents/rules/sdlc-gates.md +0 -45
- package/.agents/skills/.gitkeep +0 -0
- package/.agents/skills/agents-config/SKILL.md +0 -32
- package/.claude/.gitkeep +0 -0
- package/.claude/CLAUDE.md +0 -19
- package/.claude/agents/.gitkeep +0 -0
- package/.claude/agents/docs.md +0 -15
- package/.claude/agents/sdlc-analyst.md +0 -29
- package/.claude/agents/sdlc-architect.md +0 -31
- package/.claude/agents/sdlc-auditor.md +0 -44
- package/.claude/agents/sdlc-dev.md +0 -33
- package/.claude/agents/sdlc-orchestrator.md +0 -69
- package/.claude/agents/sdlc-pm.md +0 -32
- package/.claude/agents/sdlc-qa.md +0 -33
- package/.claude/agents/sdlc-reviewer.md +0 -31
- package/.claude/agents/sdlc-security.md +0 -36
- package/.claude/agents/sdlc-sm.md +0 -31
- package/.claude/commands/.gitkeep +0 -0
- package/.claude/commands/sdlc.md +0 -18
- package/.claude/rules/.gitkeep +0 -0
- package/.claude/rules/programming-best-practices.md +0 -18
- package/.claude/skills/.gitkeep +0 -0
- package/.claude/skills/README.md +0 -3
- package/.claude/skills/sdlc-regulatory/SKILL.md +0 -515
- package/.opencode/.gitkeep +0 -0
- package/.opencode/AGENTS.md +0 -34
- package/.opencode/agent/.gitkeep +0 -0
- package/.opencode/agent/docs.md +0 -15
- package/.opencode/agent/sdlc-analyst.md +0 -30
- package/.opencode/agent/sdlc-architect.md +0 -32
- package/.opencode/agent/sdlc-auditor.md +0 -45
- package/.opencode/agent/sdlc-dev.md +0 -34
- package/.opencode/agent/sdlc-orchestrator.md +0 -70
- package/.opencode/agent/sdlc-pm.md +0 -33
- package/.opencode/agent/sdlc-qa.md +0 -34
- package/.opencode/agent/sdlc-reviewer.md +0 -32
- package/.opencode/agent/sdlc-security.md +0 -37
- package/.opencode/agent/sdlc-sm.md +0 -32
- package/.opencode/command/.gitkeep +0 -0
- package/.opencode/command/sdlc.md +0 -18
- package/.opencode/plugin/.gitkeep +0 -0
- package/.opencode/skill/.gitkeep +0 -0
- package/.opencode/skill/sdlc-regulatory/SKILL.md +0 -515
- package/docs/adr/0001-triple-mirror.md +0 -81
- package/docs/adr/0002-zero-edit-install.md +0 -237
- /package/{.agents → docs/adr}/.gitkeep +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-analyst.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-architect.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-auditor.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-dev.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-pm.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-qa.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-reviewer.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-security.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-sm.md +0 -0
- /package/{.agents/commands → instructions/command}/sdlc.md +0 -0
- /package/{.opencode/skill → instructions/skills}/archivarius/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/data-engineer/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/find-skills/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/frontend-design/SKILL.md +0 -0
- /package/{.agents → instructions}/skills/sdlc-regulatory/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-bitcoin-auditor/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-frontend-dev/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-qa/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-software-developer/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-solidity-auditor/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-ux-ui-designer/SKILL.md +0 -0
|
@@ -1,237 +0,0 @@
|
|
|
1
|
-
# ADR 0002 — Permit a constrained postinstall file-pointer helper (zero-edit-install)
|
|
2
|
-
|
|
3
|
-
- **Status**: accepted
|
|
4
|
-
- **Date**: 2026-08-18
|
|
5
|
-
- **Deciders**: maintainer
|
|
6
|
-
- **Supersedes / narrows**: `ARCHITECTURE.md` rule 6; `docs/adr/0001-triple-mirror.md` alt.2; `docs/BUSINESS_LOGIC.md` non-goal ("This repo does not ship runtime application code").
|
|
7
|
-
- **Traceability id (slug)**: `zero-edit-install`.
|
|
8
|
-
|
|
9
|
-
## Context
|
|
10
|
-
|
|
11
|
-
`@daochild/agents-config` is a configuration-only npm package. Consumers install it as a dev
|
|
12
|
-
dependency and currently must hand-edit their `AGENTS.md` to add one pointer line:
|
|
13
|
-
|
|
14
|
-
```
|
|
15
|
-
Primary instructions: node_modules/@daochild/agents-config/AGENTS.md — follow unless overridden below.
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
This is adoption friction: a step that is forgotten, done inconsistently, or lost on a fresh
|
|
19
|
-
clone. The maintainer wants `npm install --save-dev @daochild/agents-config` alone to be
|
|
20
|
-
sufficient (the consumer only restarts their agent session).
|
|
21
|
-
|
|
22
|
-
The natural mechanism is an npm `postinstall` script. But three currently-stated repo
|
|
23
|
-
invariants forbid runtime code / install-time steps:
|
|
24
|
-
|
|
25
|
-
1. `ARCHITECTURE.md` rule 6 — "No runtime code. This repo's 'code' is configuration. The only JS
|
|
26
|
-
is the opencode plugin host (`@opencode-ai/plugin` dependency) and any
|
|
27
|
-
`.opencode/plugin/*.ts|.js` the user adds. There is no `src/`, no build output, no deployable
|
|
28
|
-
service."
|
|
29
|
-
2. `docs/adr/0001-triple-mirror.md` alt.2 — "Generate `.claude/` from `.opencode/` at install
|
|
30
|
-
time. Rejected: adds a build step to a config-only repo and couples the tools' release
|
|
31
|
-
cadences."
|
|
32
|
-
3. `docs/BUSINESS_LOGIC.md` non-goal — "This repo does not ship runtime application code."
|
|
33
|
-
|
|
34
|
-
This ADR narrows (does not abolish) those invariants to permit a single, tightly-constrained
|
|
35
|
-
install-time helper.
|
|
36
|
-
|
|
37
|
-
### Maintainer decisions (binding inputs to this ADR, recorded for traceability)
|
|
38
|
-
|
|
39
|
-
The maintainer reviewed the PRD (`docs/business/zero-edit-install-prd.md`, Revision 2) and
|
|
40
|
-
approved it with four open items resolved. These are binding decisions for this ADR and the
|
|
41
|
-
downstream implementation; they are not re-litigated here:
|
|
42
|
-
|
|
43
|
-
1. **Pointer line uses the em dash `—` (U+2014).** PRD AC-4 stands as written — the line is
|
|
44
|
-
byte-identical to
|
|
45
|
-
`Primary instructions: node_modules/@daochild/agents-config/AGENTS.md — follow unless overridden below.`
|
|
46
|
-
2. **`--init` flag is kept.** PRD US-5 / AC-6 / EC-2 stand as written — the script supports an
|
|
47
|
-
explicit `--init` flag that creates a minimal `AGENTS.md` when none exists.
|
|
48
|
-
3. **Monorepo / workspace (PRD EC-10) — architect MAY defer** with a documented limitation
|
|
49
|
-
covered by the manual fallback. The direct-dependency check is locked to `<cwd>/package.json`
|
|
50
|
-
only; the script does not traverse parents or workspaces (PRD EC-18).
|
|
51
|
-
4. **PRD EC-17 — `peerDependencies` and `optionalDependencies` are NOT "direct".** PRD AC-11 and
|
|
52
|
-
EC-17 stand as the PM wrote them: peer/optional-only presence → suppress (no-op, exit 0).
|
|
53
|
-
|
|
54
|
-
**Human approval recorded for the Requirement Gate**: approver = maintainer, date = 2026-08-18.
|
|
55
|
-
(To be recorded in the eventual DoD audit per PRD AC-D6.)
|
|
56
|
-
|
|
57
|
-
## Decision
|
|
58
|
-
|
|
59
|
-
Permit **one** constrained install-time helper: a `postinstall` script at
|
|
60
|
-
`scripts/postinstall.js` (CommonJS, matching the repo's `"type": "commonjs"`), wired via
|
|
61
|
-
`package.json` → `"scripts" → "postinstall": "node scripts/postinstall.js"`.
|
|
62
|
-
|
|
63
|
-
### The postinstall contract (binding; must NOT change without human approval)
|
|
64
|
-
|
|
65
|
-
The script is bounded by these contract clauses. Relaxing any of them is a high-risk change
|
|
66
|
-
requiring human approval at the Architecture, Security, and Code Review gates (per the
|
|
67
|
-
`sdlc-regulatory` skill):
|
|
68
|
-
|
|
69
|
-
- **Idempotent.** Running install any number of times does not duplicate the pointer line.
|
|
70
|
-
- **Safe-append only.** Never overwrites existing `AGENTS.md` content. Inserts the pointer line
|
|
71
|
-
if missing; no-op if present; never deletes existing lines.
|
|
72
|
-
- **Always exits 0.** Every code path (happy path, no-op, missing file, `--init`, permission
|
|
73
|
-
error, unexpected exception) exits 0. The script must never break `npm install`. Errors are
|
|
74
|
-
notices to stdout, never thrown as non-zero exits.
|
|
75
|
-
- **cwd-scoped.** Reads/writes only within the npm-provided `cwd` (the consumer's project root).
|
|
76
|
-
Does not touch the home directory, global config, parent directories, or sibling projects.
|
|
77
|
-
Does not traverse parents or workspaces.
|
|
78
|
-
- **Deterministic.** No network calls, no telemetry, no `Date`/`Math.random`. No imports of
|
|
79
|
-
`http`, `https`, `net`, `fetch`, `dns`, or `child_process`. Output is a pure function of
|
|
80
|
-
(`AGENTS.md` content, flags, `<cwd>/package.json` content).
|
|
81
|
-
- **Direct-dependency only (transitive suppression).** Only writes when
|
|
82
|
-
`@daochild/agents-config` is a direct dependency (listed in the consumer's `dependencies` or
|
|
83
|
-
`devDependencies` in `<cwd>/package.json`). Transitive installs no-op. `peerDependencies` and
|
|
84
|
-
`optionalDependencies` do NOT count as direct (PRD EC-17). This is a blast-radius reduction
|
|
85
|
-
control.
|
|
86
|
-
- **No silent file creation.** If no `AGENTS.md` exists in `cwd` and no `--init` flag is passed,
|
|
87
|
-
the script prints a notice and exits 0; it does not create `AGENTS.md`. With `--init`, it
|
|
88
|
-
creates a minimal `AGENTS.md` (shape defined in the architecture artifact).
|
|
89
|
-
- **Pointer-line content is fixed.** The exact line is byte-identical to the canonical line
|
|
90
|
-
above, including the em dash `—` (U+2014).
|
|
91
|
-
- **No new runtime dependency.** The script uses Node.js built-ins only (`fs`, `path`,
|
|
92
|
-
`process`). It introduces no production dependency.
|
|
93
|
-
- **Manual fallback remains documented.** `README.md` documents both the automatic (postinstall)
|
|
94
|
-
path and the manual (one-line edit) path. The manual path is the supported fallback for
|
|
95
|
-
consumers who use `--ignore-scripts` or whose CI rejects `postinstall`.
|
|
96
|
-
|
|
97
|
-
### How this narrows the superseded invariants (not abolishes)
|
|
98
|
-
|
|
99
|
-
1. **`ARCHITECTURE.md` rule 6** — narrowed from "No runtime code" to:
|
|
100
|
-
> No runtime *application* code. This repo's "code" is configuration. The only JS is the
|
|
101
|
-
> opencode plugin host (`@opencode-ai/plugin` dependency), any
|
|
102
|
-
> `.opencode/plugin/*.ts|.js` the user adds, **and one constrained install-time
|
|
103
|
-
> file-pointer helper (`scripts/postinstall.js`) permitted by ADR 0002**. There is no
|
|
104
|
-
> `src/`, no build output, no deployable service, no long-running process.
|
|
105
|
-
The general "no runtime application code" stance is retained; only this specific, bounded
|
|
106
|
-
helper is permitted.
|
|
107
|
-
|
|
108
|
-
2. **`docs/adr/0001-triple-mirror.md` alt.2** — distinguished, not superseded. Alt.2 rejected
|
|
109
|
-
*generating config in this repo* at install time (which would couple the opencode and Claude
|
|
110
|
-
Code release cadences). This ADR permits writing a *one-line pointer in the consumer's
|
|
111
|
-
file* at install time. The distinction: alt.2 was about producing `.claude/` from `.opencode/`
|
|
112
|
-
inside the package (config generation, release coupling); this ADR is about a single-line
|
|
113
|
-
edit to a file *outside* the package in the consumer's tree (pointer installation, no release
|
|
114
|
-
coupling). The `.claude/` ↔ `.opencode/` generation remains rejected; the postinstall
|
|
115
|
-
pointer-writer is a different concern. This carve-out is explicit so alt.2's rejection is not
|
|
116
|
-
silently violated.
|
|
117
|
-
|
|
118
|
-
3. **`docs/BUSINESS_LOGIC.md` non-goal** — narrowed from "This repo does not ship runtime
|
|
119
|
-
application code" to:
|
|
120
|
-
> This repo does not ship runtime *application* code. A constrained install-time
|
|
121
|
-
> file-pointer helper (`scripts/postinstall.js`, per ADR 0002) is permitted; it is not
|
|
122
|
-
> application code (no business logic, no service, no long-running process).
|
|
123
|
-
The non-goal's intent (no app code, no service, no deployable runtime) is preserved.
|
|
124
|
-
|
|
125
|
-
## Architecture decisions carried by this ADR (see architecture artifact for detail)
|
|
126
|
-
|
|
127
|
-
These are the architecture-level decisions that resolve the PRD's "architecture decision" items.
|
|
128
|
-
Full rationale is in `docs/architecture/zero-edit-install-architecture.md`; this ADR records them
|
|
129
|
-
so they are binding:
|
|
130
|
-
|
|
131
|
-
- **Script location/entry:** `scripts/postinstall.js` (CommonJS). `package.json` gets
|
|
132
|
-
`"postinstall": "node scripts/postinstall.js"`. `package.json` `main` is NOT changed to point
|
|
133
|
-
at the postinstall; `main: "index.js"` stays (BL-1 partial resolution only — full plugin host
|
|
134
|
-
hook is out of scope).
|
|
135
|
-
- **Placement rule:** when the pointer line is missing, insert it immediately after the first
|
|
136
|
-
`# ` heading (the title). If no `# ` heading exists, prepend at the top.
|
|
137
|
-
- **`--init` template:** `# <cwd-basename>` + blank line + the pointer line + trailing newline.
|
|
138
|
-
- **Match rule:** exact byte match of the canonical line; "present anywhere in the file" counts
|
|
139
|
-
as present (conservative; avoids double-insert). User formatting with different whitespace but
|
|
140
|
-
the same canonical content is left untouched (never rewritten).
|
|
141
|
-
- **Symlink handling:** skip symlinks (do not follow), print a debug note, exit 0.
|
|
142
|
-
- **Atomic write:** write to a temp file in the same dir, then rename.
|
|
143
|
-
- **Direct-dependency detection:** read `<cwd>/package.json` with `fs.readFileSync`, parse with
|
|
144
|
-
`JSON.parse` in try/catch, check `dependencies` and `devDependencies` for
|
|
145
|
-
`@daochild/agents-config`. `process.env.npm_*` may be used only as a fast-path hint if
|
|
146
|
-
available; the authoritative check is reading `<cwd>/package.json`. Mechanism satisfies AC-9
|
|
147
|
-
and AC-8.
|
|
148
|
-
- **Monorepo / workspace (EC-10):** deferred per maintainer decision. The script checks
|
|
149
|
-
`<cwd>/package.json` only; it does not traverse parents or workspaces. Documented as a known
|
|
150
|
-
limitation covered by the manual fallback. Interacts with EC-18 (cwd-vs-workspace mismatch).
|
|
151
|
-
- **Cross-package-manager:** one Node script, one logic, regardless of manager. Behavior
|
|
152
|
-
verified and documented for npm, yarn classic, yarn berry, pnpm, bun in the architecture
|
|
153
|
-
artifact. For any manager that does not run `postinstall` by default, the manual fallback
|
|
154
|
-
covers it. No per-manager code paths.
|
|
155
|
-
|
|
156
|
-
## Consequences
|
|
157
|
-
|
|
158
|
-
**Positive**
|
|
159
|
-
|
|
160
|
-
- Zero-edit install for direct consumers; adoption friction removed.
|
|
161
|
-
- Blast radius explicitly bounded: direct-dependency-only, cwd-scoped, deterministic, exit-0,
|
|
162
|
-
safe-append, no network. The AC-11 transitive suppression is a deliberate risk-reduction
|
|
163
|
-
control (security sensitivity is High; this narrows it).
|
|
164
|
-
- The repo's "no runtime application code" stance is preserved — only a bounded helper is
|
|
165
|
-
carved out.
|
|
166
|
-
- Manual fallback documented, so consumers who refuse `postinstall` are not stranded.
|
|
167
|
-
- ADR makes the supersession explicit and traceable; no silent invariant drift.
|
|
168
|
-
|
|
169
|
-
**Negative**
|
|
170
|
-
|
|
171
|
-
- A `postinstall` script is a known npm supply-chain vector. Mitigations: the contract above
|
|
172
|
-
(deterministic, network-free, cwd-scoped, direct-only, exit-0); `SECURITY.md` update required
|
|
173
|
-
(downstream, Security Gate, PRD AC-D4); human approval required at Security and Code Review
|
|
174
|
-
gates (PRD AC-D6).
|
|
175
|
-
- The script is new runtime surface in a config-only repo. Mitigation: the ADR narrows (not
|
|
176
|
-
abolishes) the invariant; the contract clauses are binding and human-approval-gated to change.
|
|
177
|
-
- Cross-package-manager lifecycle differences (EC-11) and monorepo (EC-10) are real; the
|
|
178
|
-
latter is deferred with a documented limitation, the former is verified/documented in the
|
|
179
|
-
architecture artifact.
|
|
180
|
-
- BL-1 (`index.js` stub) is only partially resolved; the `main` field is not reconciled here.
|
|
181
|
-
|
|
182
|
-
**Mitigations**
|
|
183
|
-
|
|
184
|
-
- `sdlc-security` updates `SECURITY.md` (AC-D4) and runs the Security Gate.
|
|
185
|
-
- `sdlc-reviewer` + human run the Code Review Gate; high-risk → senior/security review (AC-D6).
|
|
186
|
-
- `sdlc-auditor` verifies the contract clauses at DoD; any violation blocks.
|
|
187
|
-
- Tests (Testing Gate) assert idempotency, safe-append, exit-0, cwd-scope, direct-only,
|
|
188
|
-
determinism (static import block), and every EC.
|
|
189
|
-
|
|
190
|
-
## Alternatives considered
|
|
191
|
-
|
|
192
|
-
1. **Keep the manual one-line edit only (do nothing).** Rejected: leaves the adoption friction
|
|
193
|
-
the maintainer explicitly wants removed.
|
|
194
|
-
2. **A `bin` CLI the consumer runs (`npx @daochild/agents-config init`).** Considered. Rejected
|
|
195
|
-
for this run: still requires a manual step (only shifts which one). Could be added later as a
|
|
196
|
-
companion to the postinstall; not required by the PRD. The manual one-line edit remains the
|
|
197
|
-
documented fallback either way.
|
|
198
|
-
3. **Generate `.claude/` from `.opencode/` at install time (ADR 0001 alt.2).** Rejected (and
|
|
199
|
-
this ADR explicitly does NOT reopen it): that couples release cadences and generates config
|
|
200
|
-
*in this repo*. The postinstall pointer-writer is a distinct, narrower concern (one line in
|
|
201
|
-
the consumer's file).
|
|
202
|
-
4. **Allow the script to write for transitive installs.** Rejected by the maintainer (PRD
|
|
203
|
-
Revision 2): a project that did not directly opt in should not have its `AGENTS.md`
|
|
204
|
-
modified. AC-11 transitive suppression is the stronger guarantee.
|
|
205
|
-
5. **Workspace-aware dependency detection (traverse parents/workspaces).** Deferred per
|
|
206
|
-
maintainer decision (EC-10/EC-18): the script checks `<cwd>/package.json` only; monorepo is
|
|
207
|
-
a documented limitation covered by the manual fallback. Solving it here would expand scope
|
|
208
|
-
and the blast radius.
|
|
209
|
-
|
|
210
|
-
## References
|
|
211
|
-
|
|
212
|
-
- `docs/business/zero-edit-install-analysis.md` — analyst artifact (Requirement Gate, pass).
|
|
213
|
-
- `docs/business/zero-edit-install-prd.md` — PRD Revision 2 (Requirement Gate, pass; maintainer
|
|
214
|
-
approved 2026-08-18).
|
|
215
|
-
- `docs/architecture/zero-edit-install-architecture.md` — architecture artifact (this gate).
|
|
216
|
-
- `ARCHITECTURE.md` — rule 6 narrowed per this ADR.
|
|
217
|
-
- `docs/BUSINESS_LOGIC.md` — non-goal narrowed per this ADR.
|
|
218
|
-
- `docs/adr/0001-triple-mirror.md` — alt.2 distinguished (not superseded) per this ADR.
|
|
219
|
-
- `SECURITY.md` — to be updated at the Security Gate (AC-D4).
|
|
220
|
-
- `docs/IMPLEMENTATION.md` — BL-1 status update (AC-D5).
|
|
221
|
-
- `sdlc-regulatory` skill — gate checklists, risk-autonomy table, compliance crosswalk.
|
|
222
|
-
|
|
223
|
-
## Risk classification (input for `sdlc-sm`)
|
|
224
|
-
|
|
225
|
-
| Axis | Assessment |
|
|
226
|
-
|------|------------|
|
|
227
|
-
| Business impact | Medium — adoption gain; regression hurts every consumer's install |
|
|
228
|
-
| Technical complexity | Medium — small script, but idempotent safe-append + cross-manager + direct-dep detection have real edges |
|
|
229
|
-
| Security sensitivity | **High** — postinstall is a supply-chain vector; mitigated by the contract + AC-11 |
|
|
230
|
-
| Data sensitivity | Low — only a local markdown file |
|
|
231
|
-
| Infrastructure impact | Low — npm publish only, no service |
|
|
232
|
-
| Financial impact | Low — no payments |
|
|
233
|
-
| Breaking-change probability | Low–Medium — `--ignore-scripts` users unaffected; CI that rejects postinstall sees a *policy* signal, not a code break; manual fallback mitigates |
|
|
234
|
-
|
|
235
|
-
Overall risk tier: **Medium/High** (driven by security sensitivity).
|
|
236
|
-
Recommended AI autonomy cap: **≤40%** for implementation stories touching the script;
|
|
237
|
-
documentation-only stories may be higher (80–100%).
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|