Orient phase · steps 01–02
Orient
Define your use case
Name the job before choosing the technology.
Build output
Leave this step with:
- Task and success criteria
- Required capabilities
- Privacy, latency, and budget limits
A practical roadmap from first use case to production. Start with one model, then add the layers that make your AI useful, safe, and replaceable.
Architecture blueprint
Keep routine or sensitive work local and escalate selectively.
Local + cloud
Route by task
Unified API
Same harness contract
Context + tools
RAG · memory · checks
Build state · 0/10 complete
Assemble one reliable layer at a time.
The roadmap
Everything is open below. Scroll from step 01 to 10; mark a step complete only if you want a lightweight checklist.
Orient phase · steps 01–02
Orient
Name the job before choosing the technology.
Build output
Leave this step with:
Orient
Compare local and cloud models against the work they must do.
Build output
Leave this step with:
Connect phase · steps 03–04
Connect
Give the harness one API for local, private GPU, and cloud inference.
Build output
Leave this step with:
Connect
Use a small local model for simple work and stronger models only when needed.
Build output
Leave this step with:
Extend phase · steps 05–06
Extend
Start with an existing harness, then make plan, act, observe, verify, and finish explicit.
Build output
Leave this step with:
Extend
Let the model reason while typed tools and portable integrations perform real work.
Build output
Leave this step with:
Ground phase · steps 07–08
Ground
Ground the model with current knowledge, durable state, and visual input only where useful.
Build output
Leave this step with:
Ground
Select relevant context and make tool access proportional to risk.
Build output
Leave this step with:
Ship phase · steps 09–10
Ship
Use external checkers and a repeatable eval set before changing model weights.
Build output
Leave this step with:
Ship
Make production behavior visible, choose a deployment shape, and optimize only after it works.
Build output
Leave this step with:
Examples to study
Use an existing harness, inspect its loop, then modify or fork it when your workflow needs something different.
A personal assistant layer that can connect to external coding harnesses and tools.
A tool-using agent with memory, skills, and support for multiple model endpoints.
A compact agent loop, unified model API, TUI, and coding-agent CLI you can extend.
Define a tool contract, validate arguments, authorize the action, and return a structured result.
Troubleshooting map
Before fine-tuning, identify the failure. The simplest correct layer is usually the most maintainable one.
Missing knowledge
Use RAG
Retrieve the right documents at request time.
Wrong calculation
Use a tool
Let Python or a domain engine do the math.
Wrong workflow
Fix the harness
Make state, tools, retries, and checks explicit.
Not capable enough
Change the model
Select a better model before fine-tuning.
System recipe
Model + provider + harness + context + tools + verification.