AI Workflow Tooling
Mark Project Builder
A Codex-first operating system for planned, reviewable project work.
Problem
AI-assisted development can move quickly, but it loses value when plans, approvals, status, and handoff evidence disappear into chat history. Mark Project Builder turns that work into durable local artifacts that can be inspected, resumed, reviewed, and mirrored into ClickUp without making ClickUp the source of truth.
Constraints
- The workflow has to support many project types instead of assuming every project is a web app.
- Local files must remain the durable source of truth while ClickUp stays a visibility mirror.
- External actions such as target edits, pushes, and deployments need explicit approval boundaries.
Approach
- Built a TypeScript CLI around intake, planning, sprint execution, status transitions, approval packets, and audit trails.
- Modeled project work as local artifacts so Codex sessions can resume from files instead of memory alone.
- Separated implementation, review, push, and deployment gates so risky actions are visible before they run.
Architecture
- Node.js CLI commands drive project creation, next-action recommendations, sprint status, dev-loop packets, and workflow audits.
- Project folders store intake, tickets, sprint execution state, approval packets, and review artifacts.
- ClickUp sync writes status, comments, schedule, and assignee visibility from local state.
Verification
- Workflow commands generate durable audit files for task status, dev-loop, review, and approval events.
- Sprint state records task transitions and local verification notes.
- Approval packets document target edit, push, and deploy boundaries before external actions proceed.
Outcomes
- Projects get a repeatable path from idea intake to sprint work and review packets.
- Codex sessions can continue work from local state after interruptions.
- The system keeps planning, implementation, verification, and visibility connected without relying on private chat context.