Skip to content

chore: add Claude Code automations (skills, subagent, spec-drift hook) - #29

Merged
turegjorup merged 3 commits into
developfrom
feature/claude-automations
Jul 7, 2026
Merged

chore: add Claude Code automations (skills, subagent, spec-drift hook)#29
turegjorup merged 3 commits into
developfrom
feature/claude-automations

Conversation

@turegjorup

Copy link
Copy Markdown
Contributor

Add the zero-dependency automations from the automation review. Stacked on #28 (shares the settings.json Stop block) — review/merge #28 first, then this retargets to develop.

Changes

  • .claude/skills/changelog-entry/ (user-invocable) — add the CHANGELOG [Unreleased] entry in the CI-enforced format (.github/workflows/changelog.yaml), with explicit guidance to match the terse house tone.
  • .claude/skills/new-resource/ (user-invocable) — scaffold a new ES-index-backed resource following the DTO + provider + filter pattern, using Event as the template.
  • .claude/agents/filter-provider-reviewer.md — subagent that reviews src/Api/Filter/ElasticSearch/ and src/Api/State/ changes for query-DSL correctness, filter-vs-sort separation, and index-contract alignment.
  • scripts/claude-hook-check-spec-drift.sh + Stop hook — warn when an src/Api/Dto/* resource changed but public/spec.yaml was not regenerated (which CI's api-spec.yml would fail on).
  • CLAUDE.md — list the new skills/subagent/hook in the automation section.

Why

These four items came out of the automation-recommender review and, unlike the Elasticsearch MCP it also suggested, need no external runtime — they're pure repo files. They target this repo's real friction points: the CI-enforced changelog format, the rigid resource-scaffolding pattern, the raw-ES-DSL filter code, and spec drift.

Deliberately excluded

  • Elasticsearch MCP — the only recommended item needing an external runtime. The sibling event-database-imports repo did not adopt one, and ad-hoc ES access via docker compose exec phpfpm curl http://elasticsearch:9200/... covers the need with no new dependency. Can be added later as a one-line docker run MCP entry if wanted.

Note

  • The .claude/skills/* and .claude/agents/* markdown isn't covered by CI's markdownlint '**/*.md' (hidden-dir glob), matching the existing update-api-spec skill.

Add two user-invocable skills (changelog-entry, new-resource), a
filter-provider-reviewer subagent for the ES filter/provider layer, and a
Stop hook that warns when an Api/Dto resource changed without regenerating
public/spec.yaml (which CI's api-spec.yml would otherwise fail on).
The Elasticsearch MCP from the automation review was intentionally left out:
it is the only recommended item needing an external runtime, the sibling
event-database-imports repo did not adopt one, and ad-hoc ES access via
`docker compose exec phpfpm curl` covers the need with no new dependency.
@github-actions

Copy link
Copy Markdown

No changes detected in API specification

…laude-automations
# Conflicts:
#	CHANGELOG.md
Base automatically changed from feature/adapt-claude-setup-from-imports to developJuly 7, 2026 09:25
@turegjorup
turegjorup merged commit f22895b into developJul 7, 2026
12 checks passed
@turegjorup
turegjorup deleted the feature/claude-automations branch July 7, 2026 09:28
Sign up for freeto 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

@turegjorup