Current State, Roadmap, and Projects as Code
· 3 min read
Part 6 of The AI-Assisted Software Engineering Workflow.
Current State
Proven or Actively Used
- Repository bootstrap instructions
- Repository-embedded agent guidance
- Markdown specifications and value-ranked milestones
- Opus/Codex cross-review
- Codex or Sonnet high-effort implementation
- Draft pull requests and Qodo review
- Codex remediation of review comments
- GitHub automation and project metadata
- Git-backed blog publishing
- YAML transformation and validation
- GitHub Pages delivery
- Terraform-managed Cloudflare DNS
- Protocol extraction after successful tasks
Active Experiments
- Portable project development images
- Dropbox-based multi-machine workspace transport
- Parallel work across machines
- More formal workflow analytics
- Declarative project definitions
Planned
- Blog authoring skill with create, preview, and publish commands
- Public blog MCP
- Automator or NPX publishing plugin
- Terraform runner plugin
- Broader GitHub management through Terraform
- Automated handoff snapshots
- Automated publication of lessons from the living document
Roadmap
Near Term
- Keep this document current as the operating model changes.
- Implement and prove
/create-blog,/preview, and/publish. - Publish a first workflow article from this source.
- Confirm Claude and Codex quota behavior through dated observations.
- Begin recording cycle-time and review-effectiveness metrics.
- Keep active project concurrency at two, with three as the normal ceiling.
Next Stage
- Build the thin Terraform runner plugin.
- Move GitHub repository configuration and Cloudflare DNS into reusable Terraform modules.
- Define a minimal declarative project schema.
- Separate organization-wide standards from generic bootstrap behavior.
- Add safe preview and approval boundaries before infrastructure changes.
- Automate work-session handoff and recovery checkpoints.
Longer Term
- Make the project definition the canonical desired state.
- Have specialized plugins claim and reconcile parts of that state.
- Keep AI clients as thin conversational interfaces over public capabilities.
- Detect drift in infrastructure, repository settings, documentation, and agent protocols.
- Turn repeated successful workflows into reusable skills and plugins.
- Publish selected lessons automatically from the private living record.
Target Model: Projects as Code
The natural endpoint is a repository that describes not only the software, but the complete system around it:
- What the project is
- How the repository is configured
- How infrastructure is provisioned
- How agents operate
- How work is prioritized
- How code is reviewed
- How documentation and content are generated
- How the system is deployed
- How lessons are captured and published
In that model, the workflow becomes:
Intent
→ declarative project definition
→ AI-assisted planning and review
→ Terraform and specialized executors
→ implementation
→ automated quality gates
→ verified deployment
→ observations
→ refined protocols
→ publication
The repository becomes the operational contract. Models can change, machines can change, and individual tools can be replaced without losing the process.
One-Sentence Definition
An AI-assisted software engineering operating system in which repository-defined protocols, specialized models, automated review gates, and declarative infrastructure turn ideas into reviewed, reproducible, shipped projects with progressively less coordination friction.
Back to the series index.