AI-ready workspace for any project

Ship faster with structured AI workflows

One command to set up PRDs, plans, and an execution loop—so you can start building, not just planning.

$ curl -fsSL https://raw.githubusercontent.com/colmarius/dot-agents/main/install.sh | bash

Review first: curl -fsSL https://raw.githubusercontent.com/colmarius/dot-agents/main/install.sh | less

Then point your agent at a real problem and iterate.

Pin a version curl -fsSL https://raw.githubusercontent.com/colmarius/dot-agents/main/install.sh | bash -s -- --ref v0.1.1

What you get

your-project/
├── AGENTS.md           # Customize for your project
└── .agents/
    ├── plans/          # todo → in-progress → completed
    ├── prds/           # Product requirements
    ├── research/       # Discoveries and context
    └── skills/         # adapt, ralph, research, tmux
⚡

Instant Setup

One command creates .agents/ with plans, PRDs, skills, and research directories.

📋

Structured Plans

Task format with dependencies, scopes, and acceptance criteria for autonomous execution.

🤖

Autonomous Execution (Ralph)

Multi-iteration execution with handoff between agent threads.

🔬

Built-in Research

Save discoveries to .agents/research/ for persistent project knowledge.

The workflow

1
Research Deep dive into requirements and constraints
→
2
PRD Define features and acceptance criteria
→
3
Plan Break down into executable tasks
→
4
Execute Ralph runs autonomously

Get started in 5 steps

1
Install curl -fsSL .../install.sh | bash
2
Adapt Run adapt
3
Research Research [topic]
4
PRD Create PRD for [feature]
5
Execute Run ralph on [plan]

Inspiration

A mindset we like: doing the thing is doing the thing — ship, observe, iterate.

Quickstart Full Docs GitHub