firman-admin/claude-workflow-bindings
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Claude Code plugin for 7-phase software development workflow - agents, skills, commands, hooks
4 commits 1 branch 0 tags 157 KiB
  • JavaScript 44.8%
  • HTML 30.4%
  • Shell 13%
  • PowerShell 6.4%
  • TypeScript 5.4%
Find a file
Exact
firman-admin 093745d96e Restore Orca support in orchestrator/tdd-runner, correctly this time 
An earlier commit (3abea1a) stripped Orca-mode from tdd-runner on the
premise that Orca was opencode-specific tooling with no Claude Code
equivalent. That premise was wrong: Orca is a standalone, harness-
agnostic multi-agent orchestrator with first-class Claude Code support
(`--agent claude` / `--provider claude`, `orca claude-teams`), verified
directly against the installed `orca agent-context --json` schema
rather than assumed from context.

- tdd-runner: restore Orca-mode detection (via `orca worktree current`
  plus an injected dispatch preamble, not just binary presence), and
  heartbeat/escalation/worker_done messaging via `orca orchestration
  send` with the verified flag set (--to/--from/--type/--task-id/
  --dispatch-id/--files-modified). Orca-mode workers skip local signal
  files and skip pushing their own branch — that worktree's a per-task
  throwaway; @orchestrator integrates it back into the feature branch.
- orchestrator: detect Orca via `orca status --json`; when reachable,
  register the task graph with `orca orchestration task-create --deps`
  (a real dependency graph, replacing hand-parsed wave headers) and
  dispatch each ready task to its own `orca worktree create --agent
  claude` — giving genuine per-task worktree isolation instead of
  parallel Task-tool subagents racing on the same working directory.
  Falls back to the existing Task-tool + signal-file dispatch when
  Orca isn't running.
2026-07-22 14:39:45 +07:00
.claude Fix opencode-to-Claude-Code translation defects in conductor workflow 2026-07-22 13:26:36 +07:00
.claude-plugin Fix plugin manifest schema, resolve placeholders, rename to claude-workflow-plugin 2026-07-21 15:52:21 +07:00
agents Restore Orca support in orchestrator/tdd-runner, correctly this time 2026-07-22 14:39:45 +07:00
commands Fix opencode-to-Claude-Code translation defects in conductor workflow 2026-07-22 13:26:36 +07:00
hooks chore: initial — Claude Code workflow plugin with agents, skills, hooks, commands 2026-07-21 13:51:24 +07:00
skills Restore Orca support in orchestrator/tdd-runner, correctly this time 2026-07-22 14:39:45 +07:00
templates/.claude Fix opencode-to-Claude-Code translation defects in conductor workflow 2026-07-22 13:26:36 +07:00
.gitignore chore: initial — Claude Code workflow plugin with agents, skills, hooks, commands 2026-07-21 13:51:24 +07:00
.mcp.json chore: initial — Claude Code workflow plugin with agents, skills, hooks, commands 2026-07-21 13:51:24 +07:00
bootstrap.ps1 Fix opencode-to-Claude-Code translation defects in conductor workflow 2026-07-22 13:26:36 +07:00
bootstrap.sh Fix opencode-to-Claude-Code translation defects in conductor workflow 2026-07-22 13:26:36 +07:00
CLAUDE.md Fix opencode-to-Claude-Code translation defects in conductor workflow 2026-07-22 13:26:36 +07:00
device-config.json.example chore: initial — Claude Code workflow plugin with agents, skills, hooks, commands 2026-07-21 13:51:24 +07:00
README.md Fix opencode-to-Claude-Code translation defects in conductor workflow 2026-07-22 13:26:36 +07:00

README.md

Claude Code Workflow Bindings

Claude Code plugin for the opencode-workflow-core 7-phase software development workflow, ported from opencode.

This session drives the workflow directly — @conductor is a stateless status/recovery-check subagent, not something you hand the whole session to. See the plugin's CLAUDE.md (auto-loaded into every session) for the actual phase-by-phase routing and gate protocol.

Install

Prerequisites

  • Claude Code installed
  • Git access to your Forgejo instance

One-liner

curl -fsSL https://git.firmanserver.com/firman-admin/claude-workflow-bindings/raw/branch/main/bootstrap.sh | bash

Or manual

# Clone to Claude plugins directory
git clone https://git.firmanserver.com/firman-admin/claude-workflow-bindings.git \
  ~/.claude/plugins/claude-workflow-plugin

# Install via Claude Code
claude plugin install claude-workflow-plugin@~/.claude/plugins/claude-workflow-plugin

Windows (PowerShell)

iex ((New-Object Net.WebClient).DownloadString('https://git.firmanserver.com/firman-admin/claude-workflow-bindings/raw/branch/main/bootstrap.ps1'))

Per-project setup

cp -r ~/.claude/plugins/claude-workflow-plugin/templates/.claude ./project/.claude

Contents

Path Purpose
.claude-plugin/plugin.json Plugin manifest
agents/*.md 11 subagent definitions
commands/*.md 3 slash commands
skills/*/SKILL.md 10 skills
hooks/hooks.json Lifecycle hooks
.mcp.json Recommended MCP servers
templates/.claude/ Per-project config templates
bootstrap.sh macOS/Linux installer
bootstrap.ps1 Windows installer

Usage

Start Claude Code in any project and just describe the feature or bug — the session follows the phase table in CLAUDE.md directly and performs every [HALT] gate itself via AskUserQuestion. There's no single command that "starts" the workflow; it starts the moment you describe work.

Use individual agents/commands as needed:

Intent Action
Status / recovery check @conductor
Map codebase @codebase-explorer
Design architecture @architect
Plan tasks @planner
Run TDD cycle /tdd-runner
Review spec @spec-reviewer
Review quality @quality-reviewer
Create PR /shipper
Debug bug /debugger
Check status /workflow-status
Verify completion /verification-gate

Forgejo Integration

Issues and PRs use curl + API only — no fj CLI dependency anywhere in this plugin (skills that mentioned fj have been converted to the same curl/API calls used elsewhere):

  • Phase 3: After plan approval, planner creates one issue per task
  • Phase 4: On task completion, orchestrator comments with commit SHA
  • Phase 6: On PR merge, shipper closes all task issues

See ~/.claude/workflow-core/reference/forgejo-api.md for full API reference (vendored by bootstrap.sh/bootstrap.ps1 — run bootstrap before relying on it).

Plugin Reference

For plugin development, see the Claude Code plugin documentation.