Skip to content

feat: agentic harness — CLAUDE.md, skills, permission settings - #91

Merged
clates merged 1 commit into
mainfrom
feat/agentic-harness
Jul 11, 2026
Merged

feat: agentic harness — CLAUDE.md, skills, permission settings#91
clates merged 1 commit into
mainfrom
feat/agentic-harness

Conversation

@clates

@clates clates commented Jul 11, 2026

Copy link
Copy Markdown
Owner

What

Instruments the repo for Claude Code sessions so recurring workflows are one command instead of re-derived context:

  • CLAUDE.md — environment bootstrap (incl. the Python 3.12-via-uv requirement; Pillow <11 won't build on 3.14), verified command table, architecture map, week-output conventions.
  • /feature skill — full pipeline: explore → plan → implement on a branch → tests → PR, with the tests-within-reason policy (happy-path Playwright coverage per use case, one pytest test per backend behavior, no boundary matrices).
  • /generate-week skill — Claude-authored themed 5-day printable weeks, fully offline (no OpenAI key), rendered via worksheet_html_renderer; the teacher guide is emitted by the same script so gitignored output dirs stay fully reproducible.
  • /test skill — pytest + Playwright invocation patterns, failure triage, port/venv troubleshooting.
  • .claude/settings.json — conservative allowlist (tests, generators, branch-safe git); push/PR/destructive ops still prompt.
  • .gitignore.claude/ is now tracked (only settings.local.json ignored); scripts/reference/ added for non-canonical bespoke one-offs.
  • frontend/.prettierignore — excludes Playwright artifacts (test-results/, playwright-report/) which broke format:check after any local e2e run.
  • scripts/generate_weather_week_series.py — canonical generate-week example, produced by a cold dry-run of the skill (11 pages: 5 instructional pairs + parent-feedback page + embedded teacher guide).

Validation

  • Backend suite: 135 passed (pre-harness baseline, ~3s)
  • E2E suite: 41 passed (22s, fresh Playwright install)
  • /generate-week cold dry-run by a subagent: clean run, 11/11 pages, all spot-checks pass; doc gaps it reported were folded back into the skill
  • /feature cold dry-run by a subagent: shipped feat: add GET /health endpoint for container healthchecks #90 (GET /health) end-to-end with 137 pytest + 41 e2e green; its findings (gh pr create --head, formatter timing, pre-existing-failure triage) folded back into the skill

🤖 Generated with Claude Code

…), settings

- CLAUDE.md: environment bootstrap, verified command table, architecture map,
  week-output conventions, skills index
- .claude/skills/feature: full explore→plan→implement→test→PR pipeline with
  'tests within reason' policy
- .claude/skills/generate-week: offline Claude-authored themed weeks rendered
  via worksheet_html_renderer; teacher guide emitted by the same script
- .claude/skills/test: pytest + Playwright invocation, triage, troubleshooting
- .claude/settings.json: conservative permission allowlist
- .gitignore: track .claude/ (except settings.local.json); ignore scripts/reference/
- scripts/generate_weather_week_series.py: canonical example produced by a cold
  dry-run of the generate-week skill (11 pages + embedded teacher guide)
- frontend/.prettierignore: exclude Playwright artifacts so format:check passes
  after local e2e runs

Both skills validated by cold subagent dry-runs: weather week generated clean
(11 pages, all spot-checks pass); /health feature PR #90 shipped with
137 pytest + 41 e2e green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@clates
clates merged commit 02c333e into main Jul 11, 2026
3 checks passed
@clates
clates deleted the feat/agentic-harness branch July 11, 2026 21:15
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