warp-os 1.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/CHANGELOG.md +327 -0
- package/LICENSE +21 -0
- package/README.md +308 -0
- package/VERSION +1 -0
- package/agents/warp-browse.md +715 -0
- package/agents/warp-build-code.md +1299 -0
- package/agents/warp-orchestrator.md +515 -0
- package/agents/warp-plan-architect.md +929 -0
- package/agents/warp-plan-brainstorm.md +876 -0
- package/agents/warp-plan-design.md +1458 -0
- package/agents/warp-plan-onboarding.md +732 -0
- package/agents/warp-plan-optimize-adversarial.md +81 -0
- package/agents/warp-plan-optimize.md +354 -0
- package/agents/warp-plan-scope.md +806 -0
- package/agents/warp-plan-security.md +1274 -0
- package/agents/warp-plan-testdesign.md +1228 -0
- package/agents/warp-qa-debug-adversarial.md +90 -0
- package/agents/warp-qa-debug.md +793 -0
- package/agents/warp-qa-test-adversarial.md +89 -0
- package/agents/warp-qa-test.md +1054 -0
- package/agents/warp-release-update.md +1189 -0
- package/agents/warp-setup.md +1216 -0
- package/agents/warp-upgrade.md +334 -0
- package/bin/cli.js +44 -0
- package/bin/hooks/_warp_html.sh +291 -0
- package/bin/hooks/_warp_json.sh +67 -0
- package/bin/hooks/consistency-check.sh +92 -0
- package/bin/hooks/identity-briefing.sh +89 -0
- package/bin/hooks/identity-foundation.sh +37 -0
- package/bin/install.js +343 -0
- package/dist/warp-browse/SKILL.md +727 -0
- package/dist/warp-build-code/SKILL.md +1316 -0
- package/dist/warp-orchestrator/SKILL.md +527 -0
- package/dist/warp-plan-architect/SKILL.md +943 -0
- package/dist/warp-plan-brainstorm/SKILL.md +890 -0
- package/dist/warp-plan-design/SKILL.md +1473 -0
- package/dist/warp-plan-onboarding/SKILL.md +742 -0
- package/dist/warp-plan-optimize/SKILL.md +364 -0
- package/dist/warp-plan-scope/SKILL.md +820 -0
- package/dist/warp-plan-security/SKILL.md +1286 -0
- package/dist/warp-plan-testdesign/SKILL.md +1244 -0
- package/dist/warp-qa-debug/SKILL.md +805 -0
- package/dist/warp-qa-test/SKILL.md +1070 -0
- package/dist/warp-release-update/SKILL.md +1211 -0
- package/dist/warp-setup/SKILL.md +1229 -0
- package/dist/warp-upgrade/SKILL.md +345 -0
- package/package.json +40 -0
- package/shared/project-hooks.json +32 -0
- package/shared/tier1-engineering-constitution.md +176 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,327 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to Warp are documented in this file.
|
|
4
|
+
|
|
5
|
+
Format: [Semantic Versioning](https://semver.org/). Sections: Added, Changed, Removed, Fixed.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## [1.1.0] - 2026-04-05
|
|
10
|
+
|
|
11
|
+
Persistent cross-session memory via [claude-mem](https://github.com/thedotmack/claude-mem). Automatic observation capture replaces manual session handoffs.
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
- **claude-mem integration.** Automatic session memory — captures every tool use, AI-compresses observations, injects progressive disclosure context index on startup, cross-session search via MCP tools (search, timeline, get_observations).
|
|
15
|
+
- **consistency-check.sh.** New Stop hook validates CLAUDE.md staleness and TODOS.md accuracy when work is done. Extracted from warp-save's consistency checks.
|
|
16
|
+
|
|
17
|
+
### Changed
|
|
18
|
+
- **Hook architecture.** Warp hooks (identity + consistency + PowerShell blocker) coexist independently with claude-mem's plugin hooks. No coordination needed — both fire on shared events.
|
|
19
|
+
- **install.sh.** Adds `npx claude-mem install` step. Cleans up lifecycle-session-start.sh from previous installs.
|
|
20
|
+
- **project-hooks.json.** SessionStart reduced to 2 hooks (identity-foundation + identity-briefing). Stop event added (consistency-check). claude-mem manages its own hooks via plugin config.
|
|
21
|
+
|
|
22
|
+
### Removed
|
|
23
|
+
- **warp-save** — session handoff skill replaced by claude-mem automatic capture. 17 → 16 skills.
|
|
24
|
+
- **lifecycle-session-start.sh** — session loading hook replaced by claude-mem context injection.
|
|
25
|
+
- **.warp/sessions/ scaffolding** — warp-setup no longer creates session directories. claude-mem uses SQLite at ~/.claude-mem/.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## [1.0.0] - 2026-04-04
|
|
30
|
+
|
|
31
|
+
First public release. 17 skills, 3 adversarial agents, 4 hooks. Clean history.
|
|
32
|
+
|
|
33
|
+
### Changed
|
|
34
|
+
- **qa-optimize absorbs qa-polish.** Three modes: `/optimize` (layers 1-3, plan-only), `/delight` (layer 4, implements visual polish + CEO delight pass), `/polish` (all 4 layers). Design token audit, copy polish, micro-interactions, and 15-minute adjacent improvements all live in Layer 4.
|
|
35
|
+
- **release-update absorbs release-retro.** Two modes: ship (diff review, docs update, version bump, push, PR, deploy, canary) and retro (commit analysis, work patterns, code quality, wins, action items). Detects mode intelligently from context. Also triggers: `/ship`, `/retro`.
|
|
36
|
+
- **Push gate.** All pushes to remote go through `/warp-release-update`. Commits happen anytime. The update skill verifies CHANGELOG, README, and CLAUDE.md are current before pushing.
|
|
37
|
+
|
|
38
|
+
### Removed
|
|
39
|
+
- **warp-integrate** — integration checks handled naturally by the orchestrator.
|
|
40
|
+
- **warp-synthesize** — roadmap synthesis handled by the orchestrator directly.
|
|
41
|
+
- **warp-resume** — session bootstrap fully handled by hooks (lifecycle-session-start + identity-briefing).
|
|
42
|
+
- **warp-qa-polish** — absorbed into warp-qa-optimize Layer 4 (delight mode).
|
|
43
|
+
- **warp-release-retro** — absorbed into warp-release-update (retro mode).
|
|
44
|
+
- **warp-qa-polish-adversarial** — removed with polish skill. 4 → 3 adversarial agents.
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## [0.5.1] - 2026-04-04
|
|
49
|
+
|
|
50
|
+
Tier consolidation. Three tiers → two. Simpler, smaller, no lost coverage.
|
|
51
|
+
|
|
52
|
+
### Changed
|
|
53
|
+
- **T1+T3 merged into single T1.** UX patterns (AskUserQuestion format, completeness scoring, scale detection, artifact I/O, completion banner) folded into Tier 1. One file instead of two. 374 → 176 lines.
|
|
54
|
+
- **T2 → adversarial-only.** Tier 2 no longer prepended to build/QA skills. Only prepended to 4 adversarial agent definitions. 212 → 48 lines. Contains: bias model, verification hierarchy, severity tags, findings format.
|
|
55
|
+
- **build.sh simplified.** Two-tier model: T1 for all skills and agents, T2 only for adversarial agents. Added adversarial agent build loop.
|
|
56
|
+
- **verify.sh updated.** Replaced tier3 checks with T1 line count (≤200) and adversarial agent parity. 11/11 checks.
|
|
57
|
+
- **install.sh updated.** Removed T3 copy, added cleanup of old tier files on upgrade.
|
|
58
|
+
- **identity-foundation.sh updated.** Removed T3 injection (merged into T1).
|
|
59
|
+
- **README.md updated.** Architecture tree, tier model description, hook descriptions — all reflect 2-tier model.
|
|
60
|
+
- **Stale references fixed.** 5 references to removed tier2-verification.md tables in warp-setup, warp-plan-onboarding, warp-plan-architect source files.
|
|
61
|
+
|
|
62
|
+
### Added
|
|
63
|
+
- **`src/adversarial/` directory.** 4 adversarial agent source files (qa-test, qa-debug, qa-optimize, qa-polish). Build.sh processes them separately with T2 prepended.
|
|
64
|
+
|
|
65
|
+
### Removed
|
|
66
|
+
- **`shared/tier3-ux-patterns.md`.** Content merged into T1. File deleted.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## [0.5.0] - 2026-03-30
|
|
71
|
+
|
|
72
|
+
Direct-first execution model. The user stays in the loop for every build and QA decision.
|
|
73
|
+
|
|
74
|
+
### Added
|
|
75
|
+
- **Dual-mode QA.** All 4 QA skills run direct + adversarial dispatch simultaneously. Auto-diff produces categorized comparison: blind spots (adversarial-only), confirmed (both), context-dependent (direct-only). 4 new adversarial agent definitions.
|
|
76
|
+
- **Figma MCP integration.** Design skill creates in Figma, build reads from Figma (`get_design_context`), QA compares against Figma (`get_screenshot`), round-trip captures live app back into Figma (`generate_figma_design`). Figma rules auto-generated during setup via `create_design_system_rules`.
|
|
77
|
+
- **Chrome extension as build canvas.** Build-code starts dev server + Chrome for live UI collaboration. User and Claude share the same browser window during implementation.
|
|
78
|
+
- **AskUserQuestion triggers.** Tier 3 gains mandatory trigger list (8 situations that MUST produce a question) + general "bias toward asking" principle.
|
|
79
|
+
- **Completeness scores in labels.** Every AskUserQuestion option label MUST include score + emoji in the label text.
|
|
80
|
+
- **Preview length rule.** AskUserQuestion previews stay under 8 lines. Full mockups in conversation text.
|
|
81
|
+
- **Reports directory.** `.warp/reports/` organized by phase: planning/, building/, qatesting/, releasing/, roadmap/. Replaces flat `.warp/pipeline/`.
|
|
82
|
+
|
|
83
|
+
### Changed
|
|
84
|
+
- **Build-code → direct.** No longer dispatched. User collaborates in real-time on TDD cycles. Chrome for visual verification, Figma for design specs.
|
|
85
|
+
- **L1 gate → inline.** Moved from TaskCompleted hook into build-code Phase 3.5 (pre-QA). User sees gate results and fixes inline.
|
|
86
|
+
- **API docs → context injection.** No longer a blocking gate hook. Injected as context when QA skills are invoked.
|
|
87
|
+
- **warp-release-launch → warp-release-update.** Honest name for what the skill does: version bump, changelog, commit, push, PR.
|
|
88
|
+
- **Orchestrator → direct-first routing.** All skills default to direct. QA additionally dispatches adversarial agents. User can request dispatch for any skill.
|
|
89
|
+
|
|
90
|
+
### Removed
|
|
91
|
+
- **warp-build-sprint** — replaced by `/loop` or manual re-invocation.
|
|
92
|
+
- **warp-build-teleport** — replaced by `/loop`. Autonomous decisions unnecessary with user present.
|
|
93
|
+
- **11 hooks** — guard-orch, guard-block-md, verify-qa-gate, verify-qa-boundary, verify-api-docs, automation-phase-boundary, automation-test-router, lifecycle-session-end, lifecycle-pre-compact, lifecycle-post-compact, lifecycle-subagent-inject, lifecycle-subagent-quicksave. Plus 2 agent hooks (TaskCompleted, SubagentStop). 15 → 4 hooks.
|
|
94
|
+
- **Hook-driven QA automation.** QA is now user-invoked, not auto-dispatched by hooks.
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## [0.4.2] - 2026-03-29
|
|
99
|
+
|
|
100
|
+
API doc registry, build visibility, and quality-of-life improvements.
|
|
101
|
+
|
|
102
|
+
### Added
|
|
103
|
+
- **API doc registry + L1 gate.** New `api_docs` section in `warp-tools.json` maps every dependency to a doc source (Context7 ID, local file, or skipped). New `verify-api-docs.sh` hook blocks cycles with unregistered or unresolved dependencies. Integrated into setup, onboarding, architect, and build-code.
|
|
104
|
+
- **Doc query receipt.** Build-code writes `doc-queries.json` in Phase 1C. The gate verifies imported libraries were actually queried — proves the agent read the docs, not just that docs exist. Three-layer defense: L3 advisory, L1 registry, L1 receipt.
|
|
105
|
+
- **Build visibility.** Build agents report real-time progress via TaskCreate/TaskUpdate. Users see each phase tick off (Red, Green, Refactor, Gate) during dispatched builds. Problem tasks surface blockers immediately.
|
|
106
|
+
- **Pre-dispatch briefing.** Orchestrator enters plan mode before dispatching build agents, presenting granular cycle steps for user approval. Plan file name controls the HUD text.
|
|
107
|
+
- **15th hook.** `verify-api-docs.sh` added to the verify concern group.
|
|
108
|
+
|
|
109
|
+
### Changed
|
|
110
|
+
- **warp-orchestrate → warp-orchestrator.** Renamed for clarity (noun, not verb). Cascading rename across all references.
|
|
111
|
+
- **warp-resume trimmed.** 326 → 89 lines. Same pattern as warp-save trim: cut preamble, MUST/MUST NOT, calibration examples.
|
|
112
|
+
- **Build-code Phase 1C rewritten.** Registry-driven doc lookup replaces advisory Context7 instructions. Resolved deps go straight to `query-docs` with stored ID.
|
|
113
|
+
- **Context7 Integration section rewritten.** Now centered on the API doc registry rather than ad-hoc queries.
|
|
114
|
+
|
|
115
|
+
### Fixed
|
|
116
|
+
- **Forced model fields removed.** Skills inherit the user's selected model instead of forcing a specific one. Likely root cause of CC5 rate limit issue.
|
|
117
|
+
- **Tier duplication in orchestrator context eliminated.**
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## [0.4.0] - 2026-03-29
|
|
122
|
+
|
|
123
|
+
Major architecture redesign: governance-by-hooks, not governance-by-prose.
|
|
124
|
+
|
|
125
|
+
### Changed
|
|
126
|
+
- **Tier 3 decomposed.** 565 lines → 99 lines. Mechanical content moved to hooks, cognitive UX patterns retained. Renamed `tier3-ux-infrastructure.md` → `tier3-ux-patterns.md`.
|
|
127
|
+
- **Tier 2 optimized.** 272 → 196 lines. Removed duplicates (bias classification, command allowlist, gate protocol). Absorbed cycle/QA protocol from Tier 3.
|
|
128
|
+
- **14 hooks renamed to taxonomy.** 6 concern groups: `lifecycle-*`, `identity-*`, `guard-*`, `verify-*`, `automation-*`. Old names cleaned up on install/upgrade.
|
|
129
|
+
- **Orchestrator thinned.** 5,409 → 3,524 tokens (-35%). State assessment and briefing moved to hooks. Orchestrator is now a pure router: read state → ask user → route → display.
|
|
130
|
+
- **Plan skills default to direct.** Orchestrator defaults plan/meta/util skills to direct execution (collaborative), build/QA/release to dispatch (fresh context).
|
|
131
|
+
- **All 24 skills normalized.** Zero mechanical boilerplate, zero stale references, all under 15k token budget.
|
|
132
|
+
|
|
133
|
+
### Added
|
|
134
|
+
- **Governance receipt.** `verify-qa-gate.sh` outputs formatted banner after every L1 gate: per-tool lines with ✓/✗, name, duration, test count, summary.
|
|
135
|
+
- **3 new verify.sh checks** (9 → 12): tier3 line count ≤100, skill token budget ≤15k, mechanical content detector.
|
|
136
|
+
- **`_warp_html.sh` utility.** Markdown → HTML with warp streak CSS. XSS-safe (HTML tag sanitization). Cross-platform browser opening.
|
|
137
|
+
- **`HOOKS.md`.** Hook lifecycle flowchart documenting all 14 hooks, events, and execution order.
|
|
138
|
+
- **First-run detection.** `lifecycle-session-start.sh` warns if project not set up.
|
|
139
|
+
- **First-run orientation.** `identity-foundation.sh` shows welcome on first use, marks `.intro-seen`.
|
|
140
|
+
- **Welcome banner.** `identity-briefing.sh` generates formatted 48-char banner with pipeline state, branch, P1 priorities, model warning.
|
|
141
|
+
- **Description fields.** Every hook entry in `project-hooks.json` has a `description` field.
|
|
142
|
+
|
|
143
|
+
### Removed
|
|
144
|
+
- Old `tier3-ux-infrastructure.md` (565 lines of mixed mechanical+cognitive content).
|
|
145
|
+
- Bias classification table from Tier 2 (duplicate of Tier 1).
|
|
146
|
+
- Command allowlist from Tier 2 (lives in `verify-qa-gate.sh`).
|
|
147
|
+
- Deterministic gate protocol from Tier 2 (IS `verify-qa-gate.sh`).
|
|
148
|
+
- State assessment phase from orchestrator (hooks handle this).
|
|
149
|
+
- Briefing kit from orchestrator (hooks inject context).
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
## [0.3.6] - 2026-03-28
|
|
154
|
+
|
|
155
|
+
Install and upgrade polish.
|
|
156
|
+
|
|
157
|
+
### Added
|
|
158
|
+
- **Stale skill/agent cleanup.** install.sh removes warp-* symlinks and agent definitions that no longer exist in the repo. Fixes ghost entries like warp-learn surviving after removal.
|
|
159
|
+
- **Smart restart detection.** warp-upgrade.sh hashes hooks config and agent definitions before/after. Only recommends restart when hooks or agents actually changed, with specific reasons. Content-only updates say "no restart needed."
|
|
160
|
+
- **Git remote in upgrade output.** Shows `Repo: github.com/...` alongside local path so you know what you're upgrading.
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## [0.3.5] - 2026-03-28
|
|
165
|
+
|
|
166
|
+
QA findings tracker — persistent checklist that gates phase progression.
|
|
167
|
+
|
|
168
|
+
### Added
|
|
169
|
+
- **Unified findings tracker** (`.warp/pipeline/qa/findings.md`). All QA skills append findings. Format: `- [ ]` OPEN, `- [x]` FIXED, `- [~]` DEFERRED. Persists across skills and sessions.
|
|
170
|
+
- **Findings gate in phase-boundary-detect.sh.** Open findings block phase/subphase progression. Writes "blocked" signal instead of boundary signal when findings remain.
|
|
171
|
+
- **FINDINGS TRACKER section** in qa-test, qa-optimize, qa-polish, and qa-debug skills. Each skill knows its role: test/optimize/polish append findings, debug marks them FIXED, orchestrator marks DEFERRED (user approval required).
|
|
172
|
+
- **DEFERRED workflow** in orchestrator. Present open findings, user chooses fix vs defer, orchestrator updates tracker accordingly.
|
|
173
|
+
|
|
174
|
+
### Fixed
|
|
175
|
+
- **Orchestrator dropped QA findings after fixing high-priority items.** Without a persistent tracker, lower-priority findings existed only in conversation context and were forgotten. Now they persist on disk with a deterministic gate.
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
## [0.3.4] - 2026-03-28
|
|
180
|
+
|
|
181
|
+
Hook-driven phase boundary QA and qa-debug improvements.
|
|
182
|
+
|
|
183
|
+
### Added
|
|
184
|
+
- **phase-boundary-detect.sh** — L1 hook on SubagentStop. Scans roadmap for completed phases/subphases when a build subagent returns. Writes `.phase-boundary` signal for agent hook dispatch. Tracks completed boundaries to prevent re-signaling.
|
|
185
|
+
- **Phase boundary agent hook** — SubagentStop agent hook reads `.phase-boundary` and auto-dispatches the full QA suite: qa-test (Exhaustive) → qa-debug (if bugs found) → qa-optimize → qa-polish. Orchestrator is completely out of the loop.
|
|
186
|
+
- **qa-debug step in QA chains** — Both SubagentStop and TaskCompleted agent hooks now dispatch qa-debug between qa-test and qa-optimize when bugs are found.
|
|
187
|
+
|
|
188
|
+
### Fixed
|
|
189
|
+
- **Orchestrator asked instead of auto-dispatching phase boundary QA.** Phase 6 said "orchestrator never dispatches QA" which was correct for cycle-level (hooks handle it) but wrong for phase/subphase boundaries. Now hook-driven at all levels.
|
|
190
|
+
- **qa-debug checked arbitrary last N commits.** Now uses session-start HEAD for full session history. Falls back to asking the user for commit range if no session HEAD exists — no more magic numbers.
|
|
191
|
+
|
|
192
|
+
### Changed
|
|
193
|
+
- **Orchestrator Phase 6 rewritten.** Clarifies: cycle QA = hooks inside build subagent, boundary QA = hooks on SubagentStop, orchestrator = display results only.
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
## [0.3.3] - 2026-03-28
|
|
198
|
+
|
|
199
|
+
Hooks fix: orch-guard was never wired up, upgrade now auto-patches project hooks.
|
|
200
|
+
|
|
201
|
+
### Added
|
|
202
|
+
- **test-failure-router.sh** — PostToolUse hook on Bash. Detects test failure output and injects routing guidance to dispatch @warp-qa-debug instead of fixing directly.
|
|
203
|
+
- **shared/project-hooks.json** — Single source of truth for per-project hook config. Both warp-setup and warp-upgrade read from it.
|
|
204
|
+
- **Auto-patch on upgrade.** warp-upgrade.sh auto-patches `settings.local.json` with latest hooks after install. Users never need to re-run /warp-setup for hook updates.
|
|
205
|
+
|
|
206
|
+
### Fixed
|
|
207
|
+
- **orch-guard.sh was never installed.** Defined in orchestrator SKILL.md frontmatter but missing from warp-setup's hook config template. The orchestrator could freely edit code files — the "architect doesn't lay bricks" guard was dead on arrival. Now included in PreToolUse config.
|
|
208
|
+
- **Dead hooks frontmatter.** Removed non-functional `hooks:` block from orchestrator SKILL.md frontmatter (hooks live in settings.local.json, not skill frontmatter).
|
|
209
|
+
|
|
210
|
+
### Changed
|
|
211
|
+
- **warp-upgrade no longer asks to re-run /warp-setup.** Upgrade patches hooks automatically. Setup is for first-time install only.
|
|
212
|
+
- **install.sh copies project-hooks.json** to `~/.warp/project-hooks.json`.
|
|
213
|
+
- **warp-setup reads hook config from template** instead of inline JSON.
|
|
214
|
+
- **TODOS.md updated** to reflect v0.3.x shipped state (24 skills, correct filenames, completed items checked).
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
## [0.3.0] - 2026-03-27
|
|
219
|
+
|
|
220
|
+
Hook architecture rewrite. Fixes the v0.2.0 Stop-fires-every-response bug. All hooks moved to correct CC lifecycle events with per-project ownership, shared JSON parsing, and adversarial review fixes.
|
|
221
|
+
|
|
222
|
+
### Added
|
|
223
|
+
- **Shared JSON parsing library** (`_warp_json.sh`). All 12 hook scripts source one parser — no jq dependency, tested against adversarial inputs (quotes, newlines, backslashes, 10KB+ markdown).
|
|
224
|
+
- **Orchestrator foundation injection** (`orchestrator-foundation.sh`). Injects Tier 1 (engineering constitution) + Tier 3 (UX patterns) into Claude's context via JSON `additionalContext` on every SessionStart. Raw stdout fallback. This is what makes Claude BE the orchestrator.
|
|
225
|
+
- **Orchestrator briefing injection** (`orchestrator-briefing.sh`). Pipeline state, priorities, branch, and last session info — injected via `additionalContext` at session start.
|
|
226
|
+
- **Post-compaction capture** (`post-compact.sh`). Saves the AI-generated `compact_summary` after context compaction.
|
|
227
|
+
- **Subagent context injection** (`subagent-inject.sh`). Injects cycle specs into build subagents at spawn time via `additionalContext`. Zero orchestrator token cost.
|
|
228
|
+
- **Subagent quicksave** (`subagent-quicksave.sh`). Lightweight state capture on subagent return.
|
|
229
|
+
- **Signal-file QA architecture.** qa-gate.sh writes `.qa-gate-result`, qa-boundary.sh checks it before writing `.qa-signal`, agent hook checks `.qa-signal` existence before dispatching. Each hook independently safe.
|
|
230
|
+
- **`[WARP]` task prefix.** Build tasks use `[WARP] Cycle 1a.1: Title` naming. qa-gate.sh filters on prefix first — instant exit 0 for non-Warp tasks. Prevents false positives from TaskCompleted's no-matcher behavior.
|
|
231
|
+
- **Session-scoped HEAD tracking.** session-start.sh writes `HEAD` to `~/.warp/sessions/.session-start-head-${session_id}`. session-end.sh captures ALL session commits, not just last 5. Concurrent Claude instances don't collide.
|
|
232
|
+
- **Graceful degradation on every hook.** Missing dependencies produce visible `[WARP WARNING]` messages, never silent failures, never crashes.
|
|
233
|
+
- **Hook health verification.** warp-setup runs post-install checks: JSON syntax, script existence/permissions, dry-run.
|
|
234
|
+
- **Glob-pattern .md allowlist.** block-md.sh reads `docs/pipeline/md-allowlist.md` with shell glob patterns. Seeded by warp-setup.
|
|
235
|
+
- **Interactive pipeline flowchart** (`docs/warp-pipeline.html`). Full vertical visualization of the Warp pipeline with hook integration highlighted.
|
|
236
|
+
|
|
237
|
+
### Changed
|
|
238
|
+
- **session-end.sh: Stop → SessionEnd.** Fires once at session termination, not after every response. The v0.2.0 bug that caused flooding.
|
|
239
|
+
- **qa-gate.sh + qa-boundary.sh: SubagentStop → TaskCompleted.** Exit 2 blocks task completion. L1 QA gate at build cycle boundaries.
|
|
240
|
+
- **All scripts: jq → pure bash.** No external JSON parser dependency. Works on Windows without jq.
|
|
241
|
+
- **All scripts: guard clauses removed.** Per-project hooks (via warp-setup) guarantee Warp context. No "is this a Warp project?" checks.
|
|
242
|
+
- **install.sh: no global hook config.** Hook configuration is per-project in `.claude/settings.local.json`, written by warp-setup. install.sh only distributes scripts.
|
|
243
|
+
- **Single SessionStart group.** Empty matcher catches all sources (startup, resume, clear, compact). No separate compact group — prevents double injection.
|
|
244
|
+
- **Repo renamed** from `warp-skills` to `WarpOS`.
|
|
245
|
+
|
|
246
|
+
### Removed
|
|
247
|
+
- **Global hooks in `~/.claude/settings.json`.** All Warp hooks moved to per-project `.claude/settings.local.json`.
|
|
248
|
+
- **Haiku prompt hook on Stop.** Tested: SessionEnd output lost. AI summaries run via orchestrator-gated qa-optimize at next session start.
|
|
249
|
+
- **4-hook SubagentStop QA chain.** Replaced by TaskCompleted + single subagent quicksave.
|
|
250
|
+
- **`stop_hook_active` guard.** No longer needed — session-end.sh fires on SessionEnd (once), not Stop (every response).
|
|
251
|
+
|
|
252
|
+
### Migration
|
|
253
|
+
- **Run `/warp-setup` on all existing projects.** The hook configuration in `.claude/settings.local.json` must be regenerated for the new events.
|
|
254
|
+
- **Restart Claude Code** after setup completes.
|
|
255
|
+
|
|
256
|
+
---
|
|
257
|
+
|
|
258
|
+
## [0.2.0] - 2026-03-27
|
|
259
|
+
|
|
260
|
+
Major architecture restructure. Skills become native Claude Code agents. Orchestrator auto-activates. QA is fully hook-driven. One-command setup for new and existing projects.
|
|
261
|
+
|
|
262
|
+
### Added
|
|
263
|
+
- **Native agent definitions.** Every skill now has an agent definition in `agents/` (Tier 1 + Tier 2). Agents are dispatched as subagents by the orchestrator with proper context isolation.
|
|
264
|
+
- **Orchestrator auto-activation.** `warp-setup` writes `"agent": "warp-orchestrate"` to project settings. The orchestrator becomes the default session agent — no manual invocation needed.
|
|
265
|
+
- **`initialPrompt` for orchestrator.** Pipeline state shows automatically on session start.
|
|
266
|
+
- **Smart bypass.** Orchestrator detects simple requests and handles them directly without subagent dispatch.
|
|
267
|
+
- **Parallel dispatch.** Design + security run in parallel after architect (the one true independence point in the planning pipeline).
|
|
268
|
+
- **warp-synthesize skill.** Roadmap synthesis extracted from orchestrator into its own skill (opus). Orchestrator stays lean.
|
|
269
|
+
- **Hook-driven QA.** SubagentStop chain: qa-boundary.sh (detect boundary) -> qa-gate.sh (run L1 tools) -> agent hook (dispatch QA subagent) -> quicksave. Orchestrator only displays saved results.
|
|
270
|
+
- **Session lifecycle hooks.** PreCompact (quicksave), SessionStart (auto-load), Stop (full save + Haiku summary). All installed globally by install.sh.
|
|
271
|
+
- **Project hooks.** PostToolUse formatting/linting/types + PreToolUse .md blocker. Auto-generated by warp-setup from warp-tools.json.
|
|
272
|
+
- **Two-layer tool architecture.** `warp_tools` (Warp-native, e.g., gitleaks) + `project_tools` (ecosystem-specific). Single JSON source of truth.
|
|
273
|
+
- **MCP server support.** `mcp_servers` section in warp-tools.json. warp-setup detects and offers Context7 (live library docs) and mgrep (semantic search).
|
|
274
|
+
- **Opinionated project template.** New projects get optional clean-architecture structure (app/ -> modules/ -> shared/) aligned with STANDARDS S8 layers.
|
|
275
|
+
- **Auto-onboarding.** warp-setup Mode B automatically dispatches warp-plan-onboarding. One command for existing projects.
|
|
276
|
+
- **Layer mapping in onboarding.** Maps existing directories to standard dependency layers for downstream skills.
|
|
277
|
+
- **Worktree support in sprint.** Optional git worktree isolation per cycle.
|
|
278
|
+
- **Parallel hypothesis testing in debug.** /fork guidance for multi-hypothesis investigation.
|
|
279
|
+
- **Version tracking.** VERSION file at repo root, `~/.warp/version` tracks installed version.
|
|
280
|
+
- **warp-upgrade.sh.** One-command upgrade: pull, build, install, show changelog, detect re-setup needs.
|
|
281
|
+
- **verify.sh expanded to 9 checks.** Added model field validation and agent definition parity.
|
|
282
|
+
- **Model field on all 23 skills.** 10 opus, 13 sonnet.
|
|
283
|
+
|
|
284
|
+
### Changed
|
|
285
|
+
- **build.sh dual output.** Now produces compiled skills (Tier 1+2+3) to dist/ AND agent definitions (Tier 1+2) to agents/.
|
|
286
|
+
- **install.sh expanded.** Installs skills (symlinks), agents (symlinks), hooks (copy), Tier 1 (copy), global hook config (jq merge into settings.json).
|
|
287
|
+
- **Orchestrator rewritten.** From roadmap producer to lean pipeline brain. Phases: State Assessment -> Routing -> Dispatch -> Evaluation -> Hard Gate -> QA Display -> Loop.
|
|
288
|
+
- **build-code Phase 3.5 simplified.** Gate logic moved to hook (bin/hooks/qa-gate.sh). Skill references hook, doesn't inline gate.
|
|
289
|
+
- **build-sprint QA simplified.** "Hooks handle QA" replaces inline trigger loop.
|
|
290
|
+
- **VERIFICATION_PATTERNS.md updated.** warp-tools.json schema (two-layer + MCP), command allowlist, CLAUDE.md mirror format.
|
|
291
|
+
- **SKILL_PATTERNS.md skill count.** 22 -> 23 (warp-synthesize added).
|
|
292
|
+
- **Context7 integration conditional.** Checks warp-tools.json for availability, falls back with explicit uncertainty flag.
|
|
293
|
+
|
|
294
|
+
### Removed
|
|
295
|
+
- **Inline gate logic in build-code.** ~186 lines replaced by hook reference.
|
|
296
|
+
- **Inline QA triggers in sprint/teleport.** Hooks handle all QA dispatch.
|
|
297
|
+
|
|
298
|
+
---
|
|
299
|
+
|
|
300
|
+
## [0.1.0] - 2026-03-20
|
|
301
|
+
|
|
302
|
+
Initial public release. 23 skills, deterministic verification, tiered foundation.
|
|
303
|
+
|
|
304
|
+
### Added
|
|
305
|
+
- 23 skills across Plan, Build, QA, Release, and Root groups
|
|
306
|
+
- Tiered shared foundation: SKILL_PATTERNS.md (all skills) + VERIFICATION_PATTERNS.md (build/QA only)
|
|
307
|
+
- Deterministic gate with Level 1 tool enforcement
|
|
308
|
+
- Test design separation (bulletproof writes manifests, build-code implements)
|
|
309
|
+
- Tiered QA: Quick per cycle, Optimize per subphase, Full per phase
|
|
310
|
+
- Engineering constitution (hard_rules/engineering-constitution.md)
|
|
311
|
+
- Dual mode: pipeline (reads prior artifacts) or standalone (asks for context)
|
|
312
|
+
- Quicksave protocol for session continuity
|
|
313
|
+
- Completeness scoring and anti-shortcut protocol
|
|
314
|
+
- build.sh with variable resolution and frontmatter extraction
|
|
315
|
+
- install.sh with per-skill symlinks and Windows support
|
|
316
|
+
- verify.sh with 7 deterministic checks
|
|
317
|
+
- Pseudocode mode (toggleable)
|
|
318
|
+
|
|
319
|
+
### Changed
|
|
320
|
+
- `warp-plan-boost` renamed to `warp-plan-scope`
|
|
321
|
+
- `warp-plan-orchestrate` renamed to `warp-orchestrate`
|
|
322
|
+
- `master-blueprint.md` renamed to `README.md` in docs/pipeline/
|
|
323
|
+
- "Master Blueprint" renamed to "Roadmap" everywhere
|
|
324
|
+
- `warp-util-startup` renamed to `warp-resume`
|
|
325
|
+
- `warp-util-save-session` + `warp-util-annotate` merged into `warp-save`
|
|
326
|
+
- `warp-debug-investigate` renamed to `warp-qa-debug`
|
|
327
|
+
- All `warp-util-*` prefixes dropped
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 WolfOnWings
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|