How samykabu/sanduq works
Sanduq packages portable agent skills and Spec Kit extensions, with the managed workflow as its central product path: an issue is scoped, implemented by an orchestrator and workers, verified, documented, and delivered through a pull request. Separate capabilities include lifecycle QA, audience-specific manuals, diagrams, project synchronization, and background task delegation. The README documents these product branches, but the supplied tree and source excerpts do not expose every extension or dispatcher detail; uncertain internal connections are therefore omitted.
Main entry points: workflow.py Workflow dispatcher · scope.py Issue scoping · delegate_dispatch.py Agent delegation · init_manual.py Manual setup
Components 20
Managed workflow
- Workflow dispatcher
extensions/workflow/scripts/workflow.py - Issue scoping
extensions/scope/scripts/scope.py - Clarification
extensions/scope/scripts/clarification.py - Plan acceptance
extensions/scope/scripts/accept_plan.py - Agent delegation
extensions/workflow/scripts/delegate_dispatch.py - Progress reporting
extensions/workflow/scripts/progress.py - Task issues
extensions/workflow/scripts/task_issues.py
Project governance
- QA lifecycle
extensions/assure/scripts/assure_init.py
Portable skills
- Task delegation skill
skills/agent-tools/skills/delegate-task/delegate.mjs - Manual setup
extensions/user-manual/scripts/init_manual.py - Manual audit
extensions/user-manual/scripts/audit_manual.py - Manual editions
extensions/user-manual/scripts/build_manual.py - Diagram export
extensions/illustrate/skill/scripts/export_diagram.py
Verification and delivery
- Evidence CI gate
extensions/workflow/scripts/ci_gate.py
Other components
- Engineer
- GitHub issue
- GitHub
- GitHub Projects
- Pull request
- Project CI
Connections 21
- Engineer → GitHub issue: files issue
- GitHub issue → Issue scoping: starts scoping
- Issue scoping → GitHub: reads issue
- Issue scoping → GitHub Projects: syncs project
- Issue scoping → Workflow dispatcher: provides scope
- Workflow dispatcher → Clarification: requests answers
- Workflow dispatcher → Plan acceptance: accepts plan
- Workflow dispatcher → Agent delegation: dispatches work
- Agent delegation → Task delegation skill: starts delegated task
- Workflow dispatcher → Task issues: tracks tasks
- Workflow dispatcher → Progress reporting: reports progress
- Workflow dispatcher → QA lifecycle: coordinates QA
- Workflow dispatcher → Evidence CI gate: checks evidence
- Project CI → Evidence CI gate: supplies run evidence
- Workflow dispatcher → Manual audit: checks documentation
- Manual setup → Manual editions: prepares build inputs
- Manual editions → GitHub: publishes PR preview
- Engineer → Manual setup: requests manual
- Engineer → Diagram export: requests diagram
- Workflow dispatcher → Pull request: opens delivery PR
- Pull request → GitHub: enters review and merge