Skip to content

Junhanliu-dev/espalier-engineering / skills/espalier-init

espalier-init

Verified

Analyze any existing codebase, discover its patterns and best practices, and generate an Espalier structure (rules, skills, wiki, pipeline) so AI coders produce code matching that project's language and conventions. Greenfield repos take the two-pass Decide-Then-Bind path (/espalier-map charts the conventions, init binds them); boilerplate repos run init normally, then map the product. Wires into Claude Code, Codex, and/or GitHub Copilot (.claude/, .agents/skills/ + .codex/, .github/).

FileKindSize
SKILL.mdskill md43.5 KB
hook-templates/check-layer-boundaries-go.shscript665 B
hook-templates/check-layer-boundaries-python.shscript821 B
hook-templates/check-layer-boundaries-typescript.shscript1.6 KB
hook-templates/copilot-hook-adapter.shscript2.4 KB
hook-templates/drift-detect.shscript5.7 KB
hook-templates/drift-helpers.shscript56.4 KB
hook-templates/espalier-outside.shexecutablescript28.8 KB
hook-templates/espalier-pr.shexecutablescript43.2 KB
hook-templates/espalier-stats.shexecutablescript27.3 KB
hook-templates/lookup-helpers.shscript9.5 KB
hook-templates/map-guard.shexecutablescript3.9 KB
hook-templates/maprun-dispatch.shexecutablescript21.0 KB
hook-templates/maprun-integration.shexecutablescript3.4 KB
hook-templates/maprun-merge.shexecutablescript2.9 KB
hook-templates/maprun-pr.shexecutablescript12.8 KB
hook-templates/maprun-verify.shexecutablescript5.0 KB
hook-templates/maprun.pyscript65.6 KB
hook-templates/parse-drift-blocks.pyscript1.1 KB
hook-templates/post-edit-wrapper.shscript2.0 KB
hook-templates/post-merge-backlink.shscript2.2 KB
hook-templates/pre-push-gate-wrapper.shscript3.0 KB
hook-templates/pre-push-gate.shscript18.1 KB
hook-templates/rebuild-commit-index.shscript2.6 KB
references/discovery-checklist.mdmarkdown18.5 KB
references/validation.mdmarkdown16.7 KB
references/wiki-templates.mdmarkdown710 B
references/wiring.mdmarkdown13.5 KB
templates/agent.mdmarkdown3.7 KB
templates/agents/harness-coder.mdmarkdown33.9 KB
templates/agents/harness-reviewer.mdmarkdown25.1 KB
templates/agents/harness-security.mdmarkdown14.0 KB
templates/agents/modes/fix-round.mdmarkdown3.0 KB
templates/agents/modes/re-review.mdmarkdown5.3 KB
templates/agents/modes/repo-audit.mdmarkdown2.8 KB
templates/agents/modes/simplification.mdmarkdown7.0 KB
templates/agents/modes/stage6-abuse-coverage.mdmarkdown1.3 KB
templates/agents/modes/wiki-sweep.mdmarkdown5.6 KB
templates/pipeline.mdmarkdown18.9 KB
templates/rules/coding-standards.mdmarkdown3.2 KB
templates/rules/development-process.mdmarkdown3.2 KB
templates/rules/engineering-structure.mdmarkdown1008 B
templates/rules/production-standards.mdmarkdown5.8 KB
templates/rules/security-standards.mdmarkdown5.6 KB
templates/scout-prompts.mdmarkdown9.0 KB
templates/skills/espalier-ask.mdmarkdown6.4 KB
templates/skills/espalier-audit.mdmarkdown10.0 KB
templates/skills/espalier-coding-references/platform-native.mdmarkdown9.4 KB
templates/skills/espalier-coding-spec.mdmarkdown496 B
templates/skills/espalier-coding.mdmarkdown4.0 KB
templates/skills/espalier-doctor.mdmarkdown8.0 KB
templates/skills/espalier-fix.mdmarkdown77.5 KB
templates/skills/espalier-grill.mdmarkdown21.5 KB
templates/skills/espalier-map.mdmarkdown20.0 KB
templates/skills/espalier-maprun.mdmarkdown31.1 KB
templates/skills/espalier-prune.mdmarkdown13.0 KB
templates/skills/espalier-repot.mdmarkdown7.6 KB
templates/skills/espalier-requirements.mdmarkdown4.7 KB
templates/skills/espalier-review.mdmarkdown4.5 KB
templates/skills/espalier-security.mdmarkdown5.6 KB
templates/skills/espalier-simplify.mdmarkdown25.0 KB
templates/skills/espalier-stages/1-2-requirements.mdmarkdown7.6 KB
templates/skills/espalier-stages/3-coding.mdmarkdown15.0 KB
templates/skills/espalier-stages/4-panel.mdmarkdown14.3 KB
templates/skills/espalier-stages/5-6-contract.mdmarkdown10.3 KB
templates/skills/espalier-stages/7-10-delivery.mdmarkdown16.8 KB
templates/skills/espalier-stages/simple.mdmarkdown14.0 KB
templates/skills/espalier-testing.mdmarkdown2.9 KB
templates/skills/espalier.mdmarkdown27.7 KB

templates/rules/development-process.md

View on GitHub
# Development Process

## Branch Strategy
{detected from git or CI config}

## Commit Conventions
{detected from git log}

## CI Checks
{existing checks + what they verify}

## Deploy & Verification
{from DISCOVERY.deploy — mechanism, exact command (or "automatic on merge"),
health check, and which environment a merged change reaches. This is what
pipeline Stage 9 runs/verifies. If DISCOVERY.deploy was null, write exactly:
"No deploy configuration discovered — Stage 9 records SKIPPED: no-deploy-config."}

## Quality Bar
{what must pass before merge — derived from CI + project conventions}

## Maintenance Commits
<!-- ESPALIER MAINTENANCE COMMITS v2 — managed anchor; fixed policy text (not scout-discovered), keep this comment -->

- Every change ships as TWO pull requests: the code PR (every path outside
  `espalier/`) and its espalier PR (all of `espalier/**` — records, convention
  index, and any doc the Stage 7 sweep refreshed). They are siblings on the
  canonical branch, not a stack; the espalier PR's body says which to merge
  first. Nothing enforces the order.
- Drift YOUR change caused rides YOUR espalier PR, as its own isolated
  `docs(espalier):` commit — the Stage 7 sweep writes it, scoped to what this
  change's diff falsified. Drift you did NOT cause stays on the weekly
  gardener lane: doctor scans and routine prune refreshes ride ONE weekly
  maintenance PR on the canonical branch (`canonical-branch` in
  `espalier/.espalier-config`). A prune for your OWN critical/expired flag may
  ride your espalier PR as its own isolated `docs:` commit; convention
  promotions ride the deciding change's espalier PR. Maintenance commits are
  never folded into feature commits — the espalier PR is a separate PR, so
  that invariant is now structural rather than a matter of discipline.
- The weekly gardener rota: one rotating dev per cadence interval runs the
  maintenance loop (worktree of the canonical branch → `/espalier-doctor` →
  `/espalier-prune` over flagged files → re-run the doctor if the prune
  cleared everything, so the shared `espalier/.doctor-stamp` says `clean` →
  one `docs: weekly espalier maintenance` PR). The rota names who — that is
  what kills "someone else surely ran it". A skipped week self-corrects: the
  stamp ages out and `doctor_due()` nags everyone again.
- Rule-canon gate: every PR touching `espalier/rules/` gets the rule owner's
  review. CODEOWNERS routes it automatically ONLY when "Require review from
  Code Owners" branch protection is on — without protection the file is
  advisory; turn protection on. Rule owners: before approving a rules PR,
  fetch canonical state and check for concurrent open rule PRs — no automated
  detector can see two PRs that are both still open.
- Union-merge caveat: GitHub's web conflict editor ignores custom merge
  drivers (including `merge=union` on `espalier/.ask-gaps.tsv`) — resolve
  union-file conflicts locally, never in the web UI.
- Pipeline commits are atomic: the coder commits one bounded unit per
  commit at a clean point, staged by path, message per the Commit
  Conventions above (`harness-coder.md` → Commit Discipline); the
  pipeline pushes them as made and never squashes — squash-merge is the
  pull request's policy.
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall