[codex] Update project Specrew assets to 0.38.0#2882
Conversation
There was a problem hiding this comment.
Pull request overview
This PR updates the repository’s Specrew-managed project state to Specrew 0.38.0, including updated platform pins, refreshed coordinator/governance surfaces, and newly generated specrew-code-rules skill surfaces across supported hosts.
Changes:
- Bumps project pins/registration to Specrew 0.38.0 (Spec Kit 0.9.4, Squad 0.10.0).
- Adds generated
specrew-code-rulesskill surfaces for GitHub, Claude, Cursor, and Agents. - Refreshes coordinator/governance guidance (including refocus and boundary handoff packet shape) and updates Claude hook bindings.
Reviewed changes
Copilot reviewed 19 out of 19 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| CLAUDE.md | Adds Specrew-managed coordinator guidance for Claude. |
| AGENTS.md | Adds Specrew-managed coordinator guidance for Agents host surface. |
| .squad/casting/registry.json | Regenerates baseline casting registry (content-equivalent, formatting/order changes). |
| .specrew/config.yml | Updates platform pins (Spec Kit / Squad) for Specrew 0.38.0 baseline. |
| .specify/extensions.yml | Updates recorded specrew-speckit extension version to 0.38.0. |
| .github/skills/specrew-refocus/SKILL.md | Updates refocus skill docs with host-specific digest rule note. |
| .github/skills/specrew-code-rules/SKILL.md | Adds new specrew-code-rules skill for GitHub host. |
| .github/skills/specrew-code-rules/.specrew-managed | Marks GitHub specrew-code-rules skill directory as Specrew-managed. |
| .github/copilot-instructions.md | Appends Specrew-managed coordinator block for Copilot instructions. |
| .github/agents/squad.agent.md | Refreshes governance guidance, including six-section human re-entry packet template. |
| .cursor/rules/specrew-code-rules/SKILL.md | Adds new specrew-code-rules rule surface for Cursor. |
| .cursor/rules/specrew-code-rules/.specrew-managed | Marks Cursor specrew-code-rules rule directory as Specrew-managed. |
| .claude/skills/specrew-refocus/SKILL.md | Updates refocus skill docs with host-specific digest rule note. |
| .claude/skills/specrew-code-rules/SKILL.md | Adds new specrew-code-rules skill for Claude host. |
| .claude/skills/specrew-code-rules/.specrew-managed | Marks Claude specrew-code-rules skill directory as Specrew-managed. |
| .claude/settings.local.json | Updates Claude hook dispatcher invocations to include HostBinding payload. |
| .agents/skills/specrew-refocus/SKILL.md | Updates refocus skill docs with host-specific digest rule note. |
| .agents/skills/specrew-code-rules/SKILL.md | Adds new specrew-code-rules skill for Agents host. |
| .agents/skills/specrew-code-rules/.specrew-managed | Marks Agents specrew-code-rules skill directory as Specrew-managed. |
| - One human authorization advances at most one boundary. `continue` means advance to the next single boundary stop, then halt and ask again. | ||
| - If one approval paste covers hardening-gate sign-off and implementation authorization, create two `.squad/decisions.md` entries that preserve the same verbatim authorization text. | ||
| - **Every boundary stop MUST use the three-section handoff format.** This is a fundamental Specrew UX guarantee, not a stylistic suggestion. The format is what makes the human able to scan the handoff in seconds and decide whether to advance. Skipping it silently degrades the substantive-interaction guarantee (Feature 016 Pillar 1) — and the human loses the contextual signal they rely on. The canonical template (copy this shape exactly at every boundary stop): | ||
| - **Every human-judgment boundary stop MUST use the six-section human re-entry packet.** This is a fundamental Specrew UX guarantee, not a stylistic suggestion. The packet is what lets the human re-enter without opening every artifact, understand why the agent stopped, choose what to inspect, shape the next phase, and approve only one boundary. The packet is the primary stop contract; do not duplicate the same stop with a legacy `=== SPECREW HANDOFF ===` block unless a transitional host/runtime explicitly requires that compatibility. The canonical template: |
VenyaBrodetskiy
left a comment
There was a problem hiding this comment.
@alonf I know I opened this PR, but basically this PR is just specrew update in this project and I saw many concerning changes which might lead to some issues in future.
I am not sure about anything, so I am asking your support to review and think if it's done by design or accidentally
| { | ||
| "type": "command", | ||
| "command": "pwsh -NoProfile -ExecutionPolicy Bypass -File \"${CLAUDE_PROJECT_DIR}/.specify/extensions/specrew-speckit/scripts/specrew-hook-dispatcher.ps1\" -Event SessionStart -HostKind claude" | ||
| "command": "pwsh -NoProfile -ExecutionPolicy Bypass -File \"${CLAUDE_PROJECT_DIR}/.specify/extensions/specrew-speckit/scripts/specrew-hook-dispatcher.ps1\" -Event SessionStart -HostKind claude -HostBinding \"eyJCb290c3RyYXBEZWxpdmVyeUV2ZW50cyI6WyJTZXNzaW9uU3RhcnQiXSwiQjNEZWxpdmVyeUV2ZW50cyI6WyJQb3N0VG9vbFVzZSIsIlVzZXJQcm9tcHRTdWJtaXQiXSwiUmVmb2N1c1RyaWdnZXJCeUV2ZW50Ijp7IlBvc3RUb29sVXNlIjoiYjMiLCJVc2VyUHJvbXB0U3VibWl0IjoiYjMifSwiU3VwcHJlc3NlZFJlZm9jdXNFdmVudHMiOltdLCJPdXRwdXRTaGFwZSI6InBsYWluLW9yLWhvb2tTcGVjaWZpY091dHB1dCIsIkRlY2lzaW9uT25seUV2ZW50cyI6W10sIkJvb3RzdHJhcERlbGl2ZXJ5TW9kZSI6InBvaW50ZXIifQ==\"" |
There was a problem hiding this comment.
@alonf does specrew manage local project settings of claude? do you think it's good design?
There was a problem hiding this comment.
@alonf 2 strange things for me here:
- I didn't ask to install cursor, I am not using it, but specrew installed it just in case?
- I think for cursor you don't need to create special instruction in .cursor/rules, as cursor respects .agents/skills and agents.md
There was a problem hiding this comment.
copilot respects skills from .agents/skills
| speckit_version: "0.8.13" | ||
| squad_version: "0.9.4" | ||
| speckit_version: "0.9.4" | ||
| squad_version: "0.10.0" |
There was a problem hiding this comment.
@alonf it used my local squad version to change config for everyone using this repo. is it good approach?
There was a problem hiding this comment.
there is a trick to ask Claude to read agents.md
just paste this instead of instruction:
"@AGENTS.md"
There was a problem hiding this comment.
what if project had AGENTS.md before specrew? I think installation of specrew will override AGENTS.md in this case? is it by design?
|
@VenyaBrodetskiy — thanks for getting the self-host assets moving; they'd drifted badly (the extension registration was stuck at What I''d like this PR to cover1. Bump both dependencies to current
2. Fix the Spec Kit 0.10+ breaking changes
3. Fix the current lint failure Required validation — a real manual testThis touches the actual runtime contract with Spec Kit, so file-presence and unit-green are not enough. Please run a manual end-to-end test and paste the result into the PR:
That full-lifecycle run is the acceptance bar for this PR. One more thing — Proposal 198This drift (and the version lag) is really a symptom of a missing process step: nothing regenerates the self-host or bumps the dependencies on release, so it rots until someone notices. I''ve written Proposal 198 — Self-Host & Dependency Currency: deterministic regeneration + a release-time self-update + a per-release dependency-currency step + a CI drift gate, so this never silently happens again. (I''ll post the proposal link here in a follow-up.) Would you be interested in picking up Proposal 198 as a feature after this PR? It''s a natural follow-on from exactly the work you''re doing here — have a read once I share it and let me know. |
|
Proposal 198 is up for reading here: #2883 — have a look when you get a chance. |
|
One more small source fix to fold into the catch-up while you''re in the host model:
That, the Spec Kit 0.10+ adaptation, the pin + |
Summary
Updates this project checkout to the generated Specrew 0.38.0 project state:
.specrew/config.ymlplatform pins to Spec Kit 0.9.4 and Squad 0.10.0specrew-code-rulesskill surfaces for Agents, Claude, Cursor, and GitHubValidation
pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\specrew.ps1 --versionpwsh -NoProfile -ExecutionPolicy Bypass -File .\tests\integration\publish-module-harness.tests.ps1pwsh -NoProfile -ExecutionPolicy Bypass -File .\tests\integration\version-info-states.tests.ps1git diff --cached --checkNote:
specrew update --info --skip-update-checkwas attempted but this execution shell does not havenpmon PATH, so the Squad latest-version probe could not complete.