den-ree/blanche-skills

bindify

Use when the user references wip-docs/, .bindify/, bindify commands, plan/proposal/update/verify artifacts, coordinator workflows, multi-agent execution with shared markdown state, iterate-planning-mode, prototype-mode, verify-worktree, drafting a brief, in…

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/den-ree/blanche-skills --skill bindify

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

Bindify

Filesystem protocol for AI agents on software work. Active plan docs live in wip-docs/<feature>/<plan>/ at the project root. The tracking repo (.bindify/ or bindify/) holds architecture, migrated plans, and history/.

Load command and template files from this skill's references/ on demand. Layout detail: references/docs/layout.md. Pipeline diagrams: references/docs/workflow.md.

Three path layers

LayerWhereUse
SkillThis installCommands + templates
Active WIPwip-docs/<feature>/<plan>/Write brief/proposal/plan/updates/verify. Coordinator at wip-docs/<feature>/coordinator.md
Tracking.bindify/ or bindify/Read project/architecture; migrate development/ at packaging; history may start at draft PR

Never open tracking looking for skill commands or templates.

Read by role

RoleRead
Plannerworking-style.md, draft-brief, generate-proposal, save-agent-plan, publish-plan (branch stack), wait for ready
Executorworking-style.md, iterate-planning-mode, summarize-work-for-updates, next_step.py, generate-verify on finish
Reviewerreview-plan (build/CI gate + one fixes round)
Packagerlog-pr, publish-bindify-pr, generate-history-summary

When to invoke each command

User signalCommandReference
adapt / configure projectconfigure-projectreferences/commands/configure-project.md
coordinate updatescoordinate-updatesreferences/commands/coordinate-updates.md
capture briefdraft-briefreferences/commands/draft-brief.md
generate proposalgenerate-proposalreferences/commands/generate-proposal.md
save plan / proposal approvedsave-agent-planreferences/commands/save-agent-plan.md
/bindify / publish planpublish-planreferences/commands/publish-plan.md
run step / iterateiterate-planning-modereferences/commands/iterate-planning-mode.md
review open plan PRreview-planreferences/commands/review-plan.md
prototypeprototype-modereferences/commands/prototype-mode.md
verify worktree (macOS)verify-worktreereferences/commands/verify-worktree.md
after a stepsummarize-work-for-updatesreferences/commands/summarize-work-for-updates.md
scan architecturescan-architecturereferences/commands/scan-architecture.md
log PRlog-prreferences/commands/log-pr.md
history summary / abandonedgenerate-history-summaryreferences/commands/generate-history-summary.md
regenerate overviewregenerate-overviewreferences/commands/regenerate-overview.md
publish bindify PR / packagepublish-bindify-prreferences/commands/publish-bindify-pr.md
generate verifygenerate-verifyreferences/commands/generate-verify.md
investigate / prior fixesinvestigatereferences/commands/investigate.md
research codebaseresearch-codebasereferences/commands/research-codebase.md
repair linksupdate-linksreferences/commands/update-links.md
log hotfixlog-hotfixreferences/commands/log-hotfix.md
abandon / drop planabandon-planreferences/commands/abandon-plan.md

Hard rules

  • Active docs stay in wip-docs/<feature>/<plan>/ until packaging. Coordinator is wip-docs/<feature>/coordinator.md. Several plans of one feature can sit side by side. Read sibling plan docs before writing a proposal or plan, and again before a step. Do not write active plan artifacts into tracking development/ during apply. Flat files directly in wip-docs/ mean stop and ask.
  • Branch stack: see publish-plan.md. A different plan, while on another plan or plan-fixes branch of the same feature, is cut from the current tip. Its draft PR still targets feature/<feature-slug>. Merge that PR with a merge commit. Executors never create branches. Only review-plan creates plan-fixes/.
  • One history card per plan. Slug is <feature-slug>-<plan-slug>. Iterations and plan-fixes refresh that card.
  • Packaging migrates and deletes that plan folder only. The feature folder goes away when no plan folders remain.
  • Never modify existing plan steps during apply. Execution state → updates.md. review-plan may append steps on plan-fixes/ only.
  • Every update entry needs Impact & Connections + Architecture. Append-only for updates.md and hotfixes.md.
  • Architecture Responsibility is human-owned. scan-architecture fill appends change-log lines and edges only — and runs at packaging, not per step.
  • Package per plan on the plan head after sign-off, before the plan PR merges into its base. Feature → main is human, outside bindify. History merged = plan PR into its base.
  • Brief ≤ 150 words. Proposal: Primer ≤ 300 words (+ table); Risks ≤ 3 bullets. Primer teaches the technology; project choices are facts in In this project.
  • Prototype-first for user-facing features; Prototype steps carry a human checkpoint.
  • Repo-relative paths only. No code dumps in context files.
  • Investigate tracking names/fixes before product code. Clarify before brief.md.
  • Chat is caveman; artifacts stay normal prose. Plan/build with ponytail (references/docs/working-style.md).
  • Blanche owns agent PRs: commits --author="blanche <blanche@bindify.app>"; gh pr create via blanche_gh_token.py so author is blanche[bot]. Missing credentials → stop. See references/docs/blanche-github-app.md.
  • update-links runs at generate-verify and at migration (plus history/hotfix/architecture writes) — not after every WIP write.

Two responsibilities

PhaseDocumentWho
plan / propose / reviewbrief → proposalhuman + AI
applyplan + updatesexecutor via iterate
verifyverify.mdhuman checklist
reviewready plan PRreviewer via review-plan
packagemigrate + historypackager
abandonhistory abandonedhuman-triggered abandon-plan

What to read next

  • references/AGENTS.md — drop-in entry for host repos
  • references/docs/working-style.md — clarify, caveman, ponytail
  • references/docs/workflow.md — branch stack visuals, roles
  • references/docs/layout.md — folder trees
  • references/docs/blanche-github-app.md — App token setup
  • references/commands/<name>.md — load before invoking
  • references/templates/<name>.md — when creating artifacts

When invoking a command, read that command file first.