You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Two user-facing changes plus the deployment-pipeline fix that brings the
skill-discovery rule (discover-first protocol) to all 10 supported
providers on every fresh `aiwg use` invocation. Companion artifact: the
Novice-User Adoption study lands under .aiwg/studies/novice-user-adoption/.
Highlights:
- aiwg use warns when invoked from $HOME / / / /tmp without project signals
(3-second cancellable; AIWG_GLOBAL_INSTALL=1 suppresses; activity-log
emission on non-cancelled). Closes #1335.
- skill-discovery rule now deploys to all 10 providers:
.claude/.cursor/.codex/.factory/.opencode/.windsurf/.github + ~/.openclaw
via filesystem; Warp via WARP.md aggregation; Hermes via AGENTS.md
Top-7 priming + on-demand mcp_aiwg_rule_show. Closes #1343, #1346, #1347.
- docs/cli-reference.md + README.md document project-scope vs user-scope
trade-off with REF-720 (Lost in Multi-Turn Conversation) cross-bleed
framing. ADR-NUA-001 formalizes global install as first-class supported.
- Novice-User Adoption study deliverables: Workstream A hookup matrix,
C wizard design + CW, D global-install ADR + rough-edge inventory + comms,
E read-access audit, F engagement-surface + Lee & See trust calibration,
G 3 empirical instruments with N=1 directional data. Closes #1337, #1339,
#1340, #1341.
Pipeline fixes:
- .claude-plugin/marketplace.json metadata.version 2026.5.2 → 2026.5.5
(PUW-038 #1139 lockstep). Was caught by CI on run 2236 (commit 9c054f0)
but not blocking because the failure-mode workflow only runs on
agentic/.claude/.claude-plugin path changes.
Gates:
- npm run uat: 93 passed across 5 test files
- npx vitest run: 6,469 pass / 12 skip / 0 fail
- npx tsc --noEmit: clean
- aiwg doctor: 35/35 checks passed
Stays open by design:
- #1336 (Workstream A field-validation sprint required for PASS)
- #1338 (D — 5-day Discord/Telegram comms window pending)
- #1342 (citation-validate sweep dormant per epic)
- #1344 (AIWG.md generator wiring for new template fragment deferred)
- #1345 (OpenClaw skills-count anomaly investigation)
Two user-facing changes plus the deployment-pipeline fix that makes the
15
+
discover-first protocol reach all 10 supported providers on every fresh
16
+
`aiwg use` invocation. Companion artifact: the Novice-User Adoption study
17
+
(Workstreams A-G), landed under `.aiwg/studies/novice-user-adoption/`.
18
+
19
+
### Why this matters to users
20
+
21
+
| What changed | What it gives you |
22
+
|---|---|
23
+
|**`aiwg use` warns when invoked from `$HOME` / `/` / `/tmp`**| First-run protection. When `aiwg use sdlc` runs from a directory with no project signals (`.git`, `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `pom.xml`, `Gemfile`, `build.gradle`, `*.csproj`), AIWG emits a 3-second cancellable warning naming the target directory and pointing at recovery. `AIWG_GLOBAL_INSTALL=1` suppresses the delay; non-cancelled emissions write `warn:no-project-signal` to `.aiwg/activity.log`. Stat-only walk completes in <50ms (CI-enforced). |
24
+
|**Discover-first protocol now reaches every provider**| Before this release, the `skill-discovery` rule (mandates `aiwg discover` before declining a request or improvising a workflow) was deployed only to Claude Code and Cursor. Eight other providers had stale leftover copies or no copy at all. After this release, every provider's `aiwg use` invocation deploys the current rule body to its native rules directory, or — for Warp and Hermes — inlines it into the appropriate aggregation surface (WARP.md and AGENTS.md priming). |
25
+
|**Documented scope-model trade-off (REF-720)**|`docs/cli-reference.md` and `README.md` now document the project-scope (default) vs user-scope (global install) trade-off side-by-side, citing the REF-720 cross-context-bleed evidence (39% capability drop). ADR-NUA-001 formalizes global install as a first-class supported flow with project-scope remaining the recommended default. |
26
+
27
+
### Added
28
+
29
+
-`src/cli/project-isolation/` — new module (signals.ts, detect.ts, warning.ts, index.ts) wiring the project-isolation warning into `UseHandler.execute()`. 29 unit tests covering per-signal positive cases, walk-depth boundary (MAX_PARENT_DEPTH = 3), Ctrl-C cancellation, env-var suppression, activity-log integration, and a CI-enforced performance gate (<50ms median in a project root).
30
+
-`agentic/code/frameworks/sdlc-complete/templates/aiwg-sections/02b-discover-first.md` — new template fragment registered in the aiwg-sections manifest. Ready for downstream wiring once the fragment-based AIWG.md generator returns to the live pipeline.
31
+
-`.aiwg/studies/novice-user-adoption/` — full study deliverables across Workstreams A-G (10 baselined documents under `working/`): hookup matrix, read-access audit, wizard design + CW, engagement-surface design + Lee & See trust-calibration analysis, global-install rough-edge inventory, comms drafts, three empirical-question instruments.
32
+
- Three new follow-up tracking issues filed and resolved during the study: #1343 (rule deployment), #1346 (Warp aggregation), #1347 (Hermes priming).
33
+
34
+
### Changed
35
+
36
+
-`agentic/code/addons/aiwg-utils/manifest.json` — `consolidation.deployIndexOnly` changed from `true` to `false`. Individual rule files (skill-discovery, no-attribution, anti-laziness, etc.) now deploy alongside `RULES-INDEX.md` to every provider's rules directory. Per saved-memory `feedback_parity_no_removal`: always-deploy + adapt — no writer was removed; the deploy set was extended. Closes #1343.
37
+
-`tools/warp/setup-warp.mjs` — new `transformRuleToSection()` and `collectAiwgRulePaths()` helpers plus a "## AIWG Rules" aggregation block in `generateAIWGContent()`. Regenerated WARP.md inlines the full aiwg-utils rule bodies (skill-discovery first), turning the previous "0 discover-protocol references" into 101. Closes #1346.
38
+
-`tools/agents/providers/hermes.mjs` — `CRITICAL_RULE_DIRECTIVES` extended from Top-6 to Top-7. skill-discovery added as the first directive (governs how the agent interacts with AIWG architecturally). ~1KB compressed, well within the 19KB Hermes AGENTS.md hard cap. Closes #1347.
39
+
-`src/mcp/tools/discovery.mjs` — `rule-list` MCP tool description updated to reflect the Top-7 inlining.
40
+
-`agentic/code/frameworks/sdlc-complete/templates/copilot/copilot-instructions.md.aiwg-template` — new "Discover-First Protocol (CRITICAL)" section inlined under the AIWG SDLC Framework heading. Copilot reads `.github/copilot-instructions.md` natively, so the inline section reaches Copilot agents at session start.
41
+
-`docs/cli-reference.md` — new "Scope models: project vs user (global)" section under `aiwg use` with side-by-side comparison, REF-720 trade-off, and per-provider notes.
42
+
-`README.md` — scope-model overview added to "What AIWG Is" with project recommendation, global as first-class supported, REF-720 framing.
43
+
-`test/unit/consolidated-rules.test.ts` — 2 tests rewritten to verify the new positive contract (aiwg-utils rules included, skill-discovery in returned set). 53/53 pass.
44
+
45
+
### Fixed
46
+
47
+
-`.claude-plugin/marketplace.json` — bumped `metadata.version` from 2026.5.2 → 2026.5.5 to satisfy the PUW-038 (#1139) lockstep check with `package.json`. The marketplace version had drifted across 2026.5.3 and 2026.5.4 releases; this release brings it back into lockstep.
48
+
- Stale `.claude/rules/skill-discovery.md` (401 lines) and `.cursor/rules/skill-discovery.md` (334 lines) had drifted from the source-of-truth (400 lines, md5 `93a41b...`). Next `aiwg use` invocation overwrites them with the current source.
49
+
50
+
### Audit / Documentation
51
+
52
+
-`.aiwg/studies/novice-user-adoption/working/hookup-matrix.md` — full per-platform discovery-hookup matrix; 10/10 providers structurally parity-fixed across cycles 3 and 4. Field-validation gap (behavioral verification per provider) remains as residual work tracked in #1336.
53
+
- Evidence-type taxonomy extension: introduces `deployment-scripted` as an intermediate evidence type between `static-flagged` (file:line reference only) and `scripted` (CI-verifiable behavior). Stronger than static-flagged because it confirms deployment delivers right files to right paths; weaker than full scripted because it does not verify agent behavior on the provider.
0 commit comments