herakles

Creates a well-structured GitHub issue from a tagline or short description in any repository, investigating for duplicates and invoking the grill skill (grill-with-docs / grill-me) as a mandatory gate before drafting, using the project's issue template and label conventions, and capturing UI/UX context (screenshots, design references, accessibility, responsive, theme) when the change is user-facing. Use when the user runs /create-issue or asks to file a GitHub issue.

Turns a raw idea or feature request (no GitHub issue) into a confirmed mini-spec by asking follow-up questions about scope, desired outcome, and success criteria, then implements it with the same rigor as /implement-issue: reads AGENTS.md/area context and applicable stack/conventions skills, runs a full-context investigation, invokes the grill skill when registered, presents exactly three options and stops for the user's choice before coding, updates the branch against origin's default branch, implements the chosen option, searches project context for DEFINITION_OF_READY.md before implementation, runs verification (UI/UX checks plus the project's full check gate), reviews against the spec's success criteria and project-context DEFINITION_OF_DONE.md before handoff, runs a /review code review, and always hands off via /create-pr. Use when the user runs /implement-idea or wants to build something that is not an existing issue.

Validates a GitHub issue against the current codebase, reading the nearest AGENTS.md/CLAUDE.md, area context, and any applicable stack/conventions skills first. Runs a full-context investigation (real project commands, whole code path, no shortcuts), handles already-fixed issues by closing or adding regression tests, invokes the grill skill when registered, then presents implementation options and stops for the user's choice before coding. Updates the branch against origin's default branch, implements the chosen option, searches project context for DEFINITION_OF_READY.md before implementation, runs verification (UI/UX checks plus the project's full check gate), reviews against the issue's acceptance criteria and project-context DEFINITION_OF_DONE.md before handoff, runs a /review code review, and always hands off via /create-pr. Use when the user runs /implement-issue with an issue number.

Language-agnostic repo structure conventions used across the user's projects in any language — the user-facing README.md structure (name, logo, description, install, usage, optional background, contribution, references), the docs/ template (application, architecture, code-style, quick-start, tooling, deployment), the AGENTS.md template with a Hard Constraints section (symlinked to CLAUDE.md), nested area AGENTS.md for multi-area repos, optional CONTRIBUTING.md, the pre-commit hook contract with Lefthook as the default and explicit alternatives, scripts directory in the project's own language, co-located tests, the .agents/skills folder symlinked to .claude/skills, and changelog generation with git-cliff. Stack-specific tools (test runners, linters, generators) live in the matching stack skill. Use when scaffolding or restructuring any repo, writing AGENTS.md or docs, or laying out folders.

Commits relevant local changes, merges origin/main when the branch is behind, pushes to the current PR branch, and refreshes PR title/body when stale. Use when the user runs /update-pr or asks to update a pull request with the latest commits.