How malekbig/taskquoin works
Taskquoin governs coding-agent runs: the CLI configures and starts a persisted plan–challenge–approval–implementation–verification–review workflow, then requires hash-bound approval before committing. Runtime adapters enforce agent capabilities while running Claude, Codex, OpenCode, or API judges; Git, skills, and optional memory support the run. The README documents the major stages and integrations; sampled source confirms selected wiring, but several runtime and CLI connections are documented rather than inspected in full.
Main entry points: feature-governed.ts Run state machine · main.ts Taskquoin CLI · workflow-cli.ts Workflow commands · runtime-executor.ts Runtime contract
Components 23
CLI and setup
- Taskquoin CLI
apps/cli/src/main.ts - Workflow commands
apps/cli/src/workflow-cli.ts - Interactive console
apps/cli/src/console.ts - Config and gates
packages/config/src/config.ts
Governed workflow
- Run state machine
packages/application/src/workflow/feature-governed.ts - Run preparation
packages/application/src/use-cases/prepare-run.ts - Workflow prompts
packages/application/src/workflow/prompts.ts - Git operations
adapters/git/src/git.ts - Sandbox and tools
adapters/local-tool/src/sandboxed.ts
Agent execution
- Runtime contract
packages/application/src/ports/runtime-executor.ts - Claude runtime
adapters/runtime-claude/src/executor.ts - Codex runtime
adapters/runtime-codex/src/executor.ts - OpenCode runtime
adapters/runtime-opencode/src/executor.ts - API judge runtime
adapters/runtime-api/src/executor.ts
Policy and skills
- Claude safety hook
adapters/hooks-claude/src/main.ts - Capability rules
packages/rules/src/rules.ts - Skill management
packages/skills/src/skills.ts - Skill quarantine
adapters/skill-store/src/skill-store.ts
Run state
- Filesystem run store
adapters/store-fs/src/store.ts - Run memory
adapters/memory-claude-mem/src/claude-mem.ts
Other components
- Engineer
- Human approver
- AI provider
Connections 27
- Engineer → Taskquoin CLI: runs commands
README.md - Taskquoin CLI → Config and gates: loads config
apps/cli/src/main.ts - Taskquoin CLI → Workflow commands: routes workflow
apps/cli/src/main.ts - Taskquoin CLI → Interactive console: opens console
apps/cli/src/main.ts - Workflow commands → Config and gates: reads workflow
apps/cli/src/workflow-cli.ts - Workflow commands → Run state machine: starts run
packages/application/src/workflow/feature-governed.ts - Workflow commands → Skill management: resolves skills
apps/cli/src/workflow-cli.ts - Workflow commands → Run memory: configures memory
apps/cli/src/workflow-cli.ts - Run state machine → Run preparation: prepares run
packages/application/src/workflow/feature-governed.ts - Run state machine → Workflow prompts: builds tasks
packages/application/src/workflow/feature-governed.ts - Run state machine → Runtime contract: dispatches agents
packages/application/src/workflow/feature-governed.ts - Run state machine → Git operations: checks and commits
README.md - Run state machine → Sandbox and tools: runs verification
README.md - Human approver → Run state machine: approves hashes
README.md - Runtime contract → Claude runtime: implemented by
- Runtime contract → Codex runtime: implemented by
- Runtime contract → OpenCode runtime: implemented by
- Runtime contract → API judge runtime: implemented by
- Claude runtime → Claude safety hook: registers hook
adapters/runtime-claude/src/executor.ts - Claude safety hook → Capability rules: evaluates policy
adapters/hooks-claude/src/main.ts - Claude runtime → Sandbox and tools: scans workspace
adapters/runtime-claude/src/executor.ts - OpenCode runtime → Sandbox and tools: runs sandboxed
adapters/runtime-opencode/src/executor.ts - API judge runtime → AI provider: sends judge request
README.md - Skill quarantine → Skill management: audits skills
adapters/skill-store/src/skill-store.ts - Taskquoin CLI → Filesystem run store: creates control store
apps/cli/src/main.ts - Run state machine → Filesystem run store: persists run state
- Run state machine → Run memory: records summary
README.md