Skip to content

scaffold: Phase 0 TDD + governance + ralph + CI#4

Merged
qte77 merged 9 commits into
mainfrom
scaffold/phase0
Apr 27, 2026
Merged

scaffold: Phase 0 TDD + governance + ralph + CI#4
qte77 merged 9 commits into
mainfrom
scaffold/phase0

Conversation

@qte77
Copy link
Copy Markdown
Owner

@qte77 qte77 commented Apr 23, 2026

Summary

Superdesign Phase 0 scaffold — establishes governance, TDD infrastructure, ralph submodule, and CI.

Commits (topic-scoped)

  1. test stubs — 5 src/test/*.test.ts files using node:test stdlib, matching package.json test:* scripts
  2. CLAUDE.md — project identity, TS+AGPLv3 stack, TDD ref
  3. AGENTS.md — architect / developer / reviewer boundaries for team mode
  4. TDD enforcement rule — Red-Green-Refactor methodology
  5. Makefile — validate / validate_quick / ralph_run / ralph_run_worktree / help
  6. .claude alignment — 3 common rules copied from qte77/claude-code-plugins + settings.json with 8 enabled plugins (planning, commit-helper, tdd-core, typescript-dev, makefile-core, docs-governance, cc-meta, workspace-setup)
  7. ralph submoduleqte77/ralph-loop-cc-tdd-wt-vibe-kanban-template
  8. compound.env — ralph config for TS/VS Code stack
  9. ci.yml — validate workflow (typecheck + lint + compile + test)

License

All new source files carry // SPDX-License-Identifier: AGPL-3.0 header. No changes to existing src/.

Verified locally

  • npm ci succeeds
  • npm run compile passes (typecheck + lint + esbuild)

Closes

Generated with Claude noreply@anthropic.com

qte77 and others added 9 commits April 23, 2026 22:34
Creates 5 TypeScript test files under src/test/ matching the
test:llm, test:core, test:read, test:write-edit, test:ls-grep-glob
scripts in package.json. Each stub uses node:test (stdlib, no new
dep) with a single passing assertion and TODO comment for Phase 1
TDD work.

Unblocks the package.json test scripts which previously referenced
non-existent dist-test files.

Co-Authored-By: Claude <noreply@anthropic.com>
Declares TS/VS Code extension stack, AGPLv3+Enterprise license
awareness, TDD enforcement ref, and AGENTS.md cross-reference.

Co-Authored-By: Claude <noreply@anthropic.com>
Scopes architect / developer / reviewer mandates for team-mode
sessions. Hand-off rules keep cross-role changes explicit.

Co-Authored-By: Claude <noreply@anthropic.com>
Strict Red-Green-Refactor for TypeScript contributions. One feature
per cycle, no impl without failing test, validate before push.
Phase 0 scaffold exempt (this PR).

Co-Authored-By: Claude <noreply@anthropic.com>
- validate: full gate (typecheck + lint + compile + test)
- validate_quick: fast gate (typecheck + lint)
- ralph_run: TDD loop dispatcher
- ralph_run_worktree: isolated worktree variant
- help: auto-generated recipe list

Co-Authored-By: Claude <noreply@anthropic.com>
Matches the qte77/claude-code-plugins marketplace repo pattern:

- Copy 3 common rules from cc-plugins/.claude/rules/:
  compound-learning.md, context-management.md, core-principles.md
  (keeps Superdesign-specific tdd-enforcement.md as additional local rule)
- Add .claude/settings.json with attribution block and 8 enabled
  plugins from qte77-claude-code-plugins marketplace:
  planning, commit-helper, tdd-core, typescript-dev, makefile-core,
  docs-governance, cc-meta, workspace-setup
  (TypeScript + TDD focus; omits Python-centric plugins)
- .gitignore: carve out .claude/settings.json and .claude/rules/
  from runtime artifacts (mirrors polyforge pattern)

Unblocks future CC subagent work — target repo now has explicit
allow/enabled policies instead of falling back to restrictive globals.

Co-Authored-By: Claude <noreply@anthropic.com>
Adds qte77/ralph-loop-cc-tdd-wt-vibe-kanban-template as ralph/
submodule. Enables make ralph_run / ralph_run_worktree targets
for automated TDD sprint execution.

Co-Authored-By: Claude <noreply@anthropic.com>
Pins ralph model selection (opus default, sonnet for simple/fix),
iteration limits, validation timeout, and TS-specific worktree
symlinks (node_modules) for ralph_run_worktree target.

Co-Authored-By: Claude <noreply@anthropic.com>
Runs typecheck + lint + compile + test suite on push/PR. Executes
each node:test file individually for clean GitHub Actions grouping.
Submodules checked out recursively for ralph/.

Co-Authored-By: Claude <noreply@anthropic.com>
@qte77 qte77 enabled auto-merge (squash) April 23, 2026 22:57
@qte77 qte77 merged commit f756668 into main Apr 27, 2026
2 checks passed
@qte77 qte77 deleted the scaffold/phase0 branch April 27, 2026 21:59
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