How aaravkalia-88/hephaestus works
Hephaestus is a set of installable coding-agent skills for auditing and repairing existing frontend and backend projects. A user invokes the router or a fixer directly; the selected workflow applies its policies, scopes any edits, gathers verification evidence, and produces a report. The frontend mode also offers optional Taste design tools. The three report checkers are included as substantial runtime modules. Relationships for the skill workflows are based on the README; unsampled skill instructions and integration details are not independently verified here.
Main entry points: hephaestus-frontend/SKILL.md Frontend Fixer · hephaestus-backend/SKILL.md Backend Fixer · hephaestus/SKILL.md Hephaestus router · frontend-policy.json Frontend policy
Components 17
Skill entrypoints
- Hephaestus router
skills/hephaestus/SKILL.md - Welcome
skills/hephaestus/README.md
Fixer workflows
- Frontend Fixer
skills/hephaestus-frontend/SKILL.md - Backend Fixer
skills/hephaestus-backend/SKILL.md
Policies and references
- Frontend policy
skills/hephaestus-frontend/policy/frontend-policy.json - Backend policy
skills/hephaestus-backend/policy/backend-policy.json - Backend workflow
skills/hephaestus-backend/references/backend.md - Taste integration
skills/hephaestus-frontend/references/taste.md - Report contract
skills/hephaestus-frontend/references/report.md - Taste tools
Report validation
- Core report checker
skills/hephaestus/scripts/check-report.mjs - Frontend report checker
skills/hephaestus-frontend/scripts/check-report.mjs - Backend report checker
skills/hephaestus-backend/scripts/check-report.mjs
Other components
- Project owner
- Coding agent
- Existing project
- Host tools
Connections 25
- Project owner → Coding agent: requests audit or repair
README.md - Coding agent → Hephaestus router: invokes
README.md - Hephaestus router → Welcome: presents
README.md - Hephaestus router → Frontend Fixer: offers mode
README.md - Hephaestus router → Backend Fixer: offers mode
README.md - Coding agent → Frontend Fixer: invokes directly
README.md - Coding agent → Backend Fixer: invokes directly
README.md - Frontend Fixer → Frontend policy: applies rules
README.md - Backend Fixer → Backend policy: applies guardrails
README.md - Backend Fixer → Backend workflow: follows workflow
README.md - Frontend Fixer → Taste integration: consults integration
README.md - Taste integration → Taste tools: describes use
README.md - Frontend Fixer → Report contract: uses contract
README.md - Backend Fixer → Report contract: uses contract
README.md - Coding agent → Existing project: audits and edits
README.md - Coding agent → Host tools: uses for verification
README.md - Coding agent → Core report checker: validates report
README.md - Coding agent → Frontend report checker: validates report
README.md - Coding agent → Backend report checker: validates report
README.md - Core report checker → Frontend policy: loads policy
skills/hephaestus/scripts/check-report.mjs - Core report checker → Backend policy: loads policy
skills/hephaestus/scripts/check-report.mjs - Frontend report checker → Frontend policy: loads policy
skills/hephaestus-frontend/scripts/check-report.mjs - Frontend report checker → Backend policy: loads policy
skills/hephaestus-frontend/scripts/check-report.mjs - Backend report checker → Frontend policy: loads policy
skills/hephaestus-backend/scripts/check-report.mjs - Backend report checker → Backend policy: loads policy
skills/hephaestus-backend/scripts/check-report.mjs