How saubakirov/trace-first-starter works
TFW is a human–AI workflow methodology and starter kit: a human chooses an Edition, copies it into a project, and follows its instructions to create durable task context, execute bounded work, and review results. The README documents Assisted handoffs and independent review, plus Full’s formal lifecycle and research, documentation, knowledge, release, update, configuration, and initialization workflows. The supplied tree is selective, so Edition and workflow nodes use documented paths; only the maintainer diagnostics’ implementation relationship is confirmed by sampled source.
Main entry points: README.md Edition choice · 02-assisted Task traces · workflows Plan task · tfw_doctor.py Diagnostics
Components 20
Project Adoption
- Edition choice
editions/README.md - Assisted edition
editions/02-assisted - Full framework
.tfw
Assisted Workflow
- Task traces
editions/02-assisted - Handoff
editions/02-assisted - Independent review
editions/02-assisted
Full Lifecycle
- Plan task
.tfw/workflows - Execute handoff
.tfw/workflows - Review work
.tfw/workflows - Research workflow
.tfw/workflows - Documentation workflow
.tfw/workflows - Knowledge workflow
.tfw/workflows - Release workflow
.tfw/workflows - Update workflow
.tfw/workflows - Configuration workflow
.tfw/workflows - Initialization workflow
.tfw/workflows
Maintainer Support
- Diagnostics
tools/tfw_doctor.py - State readers
tools/tfw_state.py
Other components
- Human owner
- AI agent
Connections 18
- Human owner → Edition choice: chooses edition
README.md - Edition choice → Assisted edition: selects
README.md - Edition choice → Full framework: selects
README.md - Human owner → AI agent: authorizes work
README.md - AI agent → Task traces: records context
README.md - Task traces → Handoff: supports handoff
- AI agent → Independent review: requests review
README.md - AI agent → Plan task: starts task
README.md - Plan task → Execute handoff: approves handoff
README.md - Execute handoff → Review work: submits completion
README.md - AI agent → Research workflow: runs workflow
README.md - AI agent → Documentation workflow: runs workflow
README.md - AI agent → Knowledge workflow: runs workflow
README.md - AI agent → Release workflow: runs workflow
README.md - AI agent → Update workflow: runs workflow
README.md - AI agent → Configuration workflow: runs workflow
README.md - AI agent → Initialization workflow: runs workflow
README.md - Diagnostics → State readers: reads task state
tools/tfw_doctor.py