Skip to content

docs(sdd): propose fix-consumer-install — 1.15.0 consumer install repair - #374

Merged
pvilarim merged 1 commit into
masterfrom
claude/fix-consumer-install-propose
Aug 14, 2026
Merged

docs(sdd): propose fix-consumer-install — 1.15.0 consumer install repair#374
pvilarim merged 1 commit into
masterfrom
claude/fix-consumer-install-propose

Conversation

@pvilarim

Copy link
Copy Markdown
Owner

What

OpenSpec propose artifacts for fix-consumer-install (kit 1.15.0): proposal, design, 9 spec deltas, and 20 gated tasks. Docs only — no code changes in this PR; implementation lands via /opsx:apply after the adversarial pass.

Why

v1.14.0 cannot be installed correctly in APP profile by any documented path — seven defects in ~40 minutes of first real consumer use, zero in 369 hub PRs. Root cause: the hub validates itself. Research: explore-consumer-install-defects, explore-agent-mediated-install, explore-python-onboarding-ux (all on master).

Scope highlights

  • Hub detection by explicit .sdd-hub marker (defects 4, 5)
  • Hub-mode --kit-root derivation + bootstrap WARN→FATAL (defect 1)
  • Delete the three self-copying MANIFEST entries (defect 2)
  • project.md template shipped; language-policy WARN→FAIL (defect 7)
  • _template ships a valid placeholder delta (defect 3)
  • Guide delivered to consumers — reverts 2026-08-05, restores 2026-06-17 founding design (defect 6, adversarial verdict §12)
  • AGENTS.md survives tool phases via pre-existence snapshot (defect 8)
  • macOS portability by construction (sed -i, bash-3.2 heredocs, portable checksum, cascade rungs, flock best-effort)
  • New capability sdd-fail-loud — a step that cannot run must say so
  • Blocking consumer APP install smoke test in CI (two variations)

Validation

  • openspec validate fix-consumer-install --strict
  • scripts/verify-task-patterns.sh ✅ (all Pattern paths OK)

Next: adversarial pass with clean-context agents, then /opsx:apply.

🤖 Generated with Claude Code

Proposal, design, 9 spec deltas (incl. new sdd-fail-loud capability) and
20 gated tasks for the seven consumer-install defects, macOS portability
by construction, and the blocking consumer APP smoke test in CI.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@pvilarim
pvilarim merged commit cf73889 into master Aug 14, 2026
1 check passed
@pvilarim
pvilarim deleted the claude/fix-consumer-install-propose branch August 14, 2026 00:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant