Skip to content

chore: pre-EPIC-03 consistency cleanup#95

Merged
steilerDev merged 1 commit into
betafrom
chore/epic03-consistency-cleanup
Feb 16, 2026
Merged

chore: pre-EPIC-03 consistency cleanup#95
steilerDev merged 1 commit into
betafrom
chore/epic03-consistency-cleanup

Conversation

@steilerDev
Copy link
Copy Markdown
Owner

Summary

Pre-epic consistency cleanup per CLAUDE.md convention, verifying repository alignment before starting EPIC-03.

Issues Found & Fixed

1. Agent definition files contradict CLAUDE.md test ownership rules

CLAUDE.md states: "Developer agents do not write tests" and "the qa-integration-tester agent owns unit tests and integration tests; the e2e-test-engineer agent owns Playwright E2E browser tests."

Both backend-developer.md and frontend-developer.md contained test-writing responsibilities in their:

  • YAML description/examples
  • Responsibilities > Testing section
  • Implementation Workflow steps
  • Quality Assurance Self-Checks
  • Strict Boundaries section

Fix: Updated both files to:

  • Explicitly state "You do not write tests"
  • Direct agents to run existing tests for verification (npm test)
  • Guide agents to write testable code (clear interfaces, injectable dependencies)
  • Update boundaries to prohibit all test types (not just E2E)
  • Replace test-writing examples with implementation examples

2. GitHub Wiki ADRs referenced old tech stack (pushed to wiki repo)

ADR Was Now
ADR-004 Vite 6 Webpack 5.x
ADR-005 Vitest Jest 30.x + ts-jest
ADR-006 Tailwind CSS v4 CSS Modules

Each ADR was rewritten to document the actual decision, the native binary constraint that motivated the change, and the correct consequences.

3. Minor fixes

  • frontend-developer.md: Stale reference to docs/api-contract.md updated to GitHub Wiki
  • frontend-developer.md: Generic CSS styling list in memory guidance updated to "CSS Modules"

Files Changed

  • .claude/agents/backend-developer.md
  • .claude/agents/frontend-developer.md
  • GitHub Wiki: ADR-004, ADR-005, ADR-006 (pushed separately to wiki repo)

Test Plan

  • npm run lint -- passes
  • npm run format:check -- passes
  • npm run typecheck -- passes
  • npm test -- 614 tests pass
  • npm run build -- succeeds
  • npm audit -- 0 vulnerabilities
  • No production code changes -- agent definitions and wiki docs only

🤖 Generated with Claude Code

CLAUDE.md states developer agents do not write tests -- the
qa-integration-tester owns unit/integration tests and the
e2e-test-engineer owns E2E tests. The backend-developer and
frontend-developer agent definition files contradicted this by
including test-writing responsibilities, workflow steps, and
examples.

Changes to agent definition files:
- backend-developer.md: Remove test-writing from responsibilities,
  workflow steps 5/7, quality checks, strict boundaries, and
  YAML description examples
- frontend-developer.md: Remove test-writing from responsibilities,
  workflow step 7, boundaries, and YAML description examples
- Both: Add explicit "you do not write tests" guidance with
  instruction to run existing tests for verification
- Fix stale reference to docs/api-contract.md (now GitHub Wiki)
- Fix stale CSS styling list in frontend memory guidance

Also updated GitHub Wiki ADRs (pushed separately):
- ADR-004: Vite 6 -> Webpack 5.x
- ADR-005: Vitest -> Jest 30.x + ts-jest
- ADR-006: Tailwind CSS v4 -> CSS Modules

Co-Authored-By: Claude product-architect (Opus 4.6) <noreply@anthropic.com>
@steilerDev steilerDev merged commit 698a8dc into beta Feb 16, 2026
4 checks passed
@steilerDev steilerDev deleted the chore/epic03-consistency-cleanup branch February 16, 2026 20:38
@github-actions
Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.7.0-beta.20 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions
Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.8.0-beta.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions
Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.8.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants