Build a file-based orchestration prototype

[dapi]

Parent: #104 — Add durable orchestration and Task Capsule model for Memory Bank

Goal

Validate the orchestration model using Git and Memory Bank documents before introducing Temporal or another runtime orchestrator.

Scope

• Create a minimal file-based runner or reproducible workflow command.
• Load a Task Capsule and select the next role/stage.
• Run the handoff validator before allowing transition.
• Persist state and evidence in the existing repository structure.
• Support pause, resume, failed handoff, and manual stop.
• Document operational usage and limitations.

Out of scope

• Temporal or other runtime orchestration.
• Parallel execution.
• Production-grade queues, retries, and timers.
• Replacing the existing task tracker.

Acceptance criteria

• A sample task can be started, paused, resumed, and completed.
• Invalid handoff blocks progression with actionable diagnostics.
• State remains recoverable from Git-backed artifacts.
• The prototype does not duplicate canonical requirements or statuses.
• Local documentation and checks are added.
• A follow-up decision records whether a runtime orchestrator is justified.

Dependencies

• Depends on Task Capsule contract.
• Depends on role/handoff protocol and validator.
• Should consume the session continuation contract.

References

• Article
• Memory Bank usage model
• Feature Flow
• Epic Flow