Rename AOC to OAC throughout README (#248)
This commit is contained in:
parent
1f9f2c0571
commit
035dc59d33
1 changed files with 15 additions and 15 deletions
30
README.md
30
README.md
|
|
@ -60,7 +60,7 @@ export async function POST(request: Request) {
|
||||||
|
|
||||||
**The result:** Production-ready code that ships without heavy rework.
|
**The result:** Production-ready code that ships without heavy rework.
|
||||||
|
|
||||||
### What Makes AOC Different
|
### What Makes OAC Different
|
||||||
|
|
||||||
**🎯 Context-Aware (Your Secret Weapon)**
|
**🎯 Context-Aware (Your Secret Weapon)**
|
||||||
Agents load YOUR patterns before generating code. Code matches your project from the start. No refactoring needed.
|
Agents load YOUR patterns before generating code. Code matches your project from the start. No refactoring needed.
|
||||||
|
|
@ -80,7 +80,7 @@ Store YOUR coding patterns once. Entire team uses same standards. Commit context
|
||||||
**🔄 Model Agnostic**
|
**🔄 Model Agnostic**
|
||||||
Use any AI model (Claude, GPT, Gemini, local). No vendor lock-in.
|
Use any AI model (Claude, GPT, Gemini, local). No vendor lock-in.
|
||||||
|
|
||||||
**Full-stack development:** AOC handles both frontend and backend work. The agents coordinate to build complete features from UI to database.
|
**Full-stack development:** OAC handles both frontend and backend work. The agents coordinate to build complete features from UI to database.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -98,7 +98,7 @@ Use any AI model (Claude, GPT, Gemini, local). No vendor lock-in.
|
||||||
| **Error Recovery** | ✅ Human-guided validation | ⚠️ Auto-retry (can loop) | ⚠️ Auto-retry | ✅ Self-correcting |
|
| **Error Recovery** | ✅ Human-guided validation | ⚠️ Auto-retry (can loop) | ⚠️ Auto-retry | ✅ Self-correcting |
|
||||||
| **Best For** | Production code, teams | Quick prototypes | Solo developers | Power users, complex projects |
|
| **Best For** | Production code, teams | Quick prototypes | Solo developers | Power users, complex projects |
|
||||||
|
|
||||||
**Use AOC when:**
|
**Use OAC when:**
|
||||||
- ✅ You have established coding patterns
|
- ✅ You have established coding patterns
|
||||||
- ✅ You want code that ships without refactoring
|
- ✅ You want code that ships without refactoring
|
||||||
- ✅ You need approval gates for quality control
|
- ✅ You need approval gates for quality control
|
||||||
|
|
@ -209,7 +209,7 @@ Add a login endpoint
|
||||||
|
|
||||||
**The problem with AI code:** It doesn't match your patterns. You spend hours refactoring.
|
**The problem with AI code:** It doesn't match your patterns. You spend hours refactoring.
|
||||||
|
|
||||||
**The AOC solution:** Teach your patterns once. Agents load them automatically. Code matches from the start.
|
**The OAC solution:** Teach your patterns once. Agents load them automatically. Code matches from the start.
|
||||||
|
|
||||||
### How It Works
|
### How It Works
|
||||||
|
|
||||||
|
|
@ -250,7 +250,7 @@ Ships without refactoring ✅
|
||||||
- Large token overhead per request
|
- Large token overhead per request
|
||||||
- Slow responses, high costs
|
- Slow responses, high costs
|
||||||
|
|
||||||
**AOC approach:**
|
**OAC approach:**
|
||||||
- Loads only relevant patterns
|
- Loads only relevant patterns
|
||||||
- Context files <200 lines (quick to load)
|
- Context files <200 lines (quick to load)
|
||||||
- Lazy loading (agents load what they need)
|
- Lazy loading (agents load what they need)
|
||||||
|
|
@ -265,7 +265,7 @@ Ships without refactoring ✅
|
||||||
|
|
||||||
**The team problem:** Every developer writes code differently. Inconsistent patterns. Hard to maintain.
|
**The team problem:** Every developer writes code differently. Inconsistent patterns. Hard to maintain.
|
||||||
|
|
||||||
**The AOC solution:** Store team patterns in `.opencode/context/project/`. Commit to repo. Everyone uses same standards.
|
**The OAC solution:** Store team patterns in `.opencode/context/project/`. Commit to repo. Everyone uses same standards.
|
||||||
|
|
||||||
**Example workflow:**
|
**Example workflow:**
|
||||||
```bash
|
```bash
|
||||||
|
|
@ -334,7 +334,7 @@ Agents are markdown files you can edit. Change workflows, add constraints, custo
|
||||||
Before generating code, ContextScout discovers relevant patterns from your context files. Ranks by priority (Critical → High → Medium). Prevents wasted work.
|
Before generating code, ContextScout discovers relevant patterns from your context files. Ranks by priority (Critical → High → Medium). Prevents wasted work.
|
||||||
|
|
||||||
**2. Editable Agents - Full Control**
|
**2. Editable Agents - Full Control**
|
||||||
Unlike Cursor/Copilot where behavior is baked into plugins, AOC agents are markdown files. Edit them directly:
|
Unlike Cursor/Copilot where behavior is baked into plugins, OAC agents are markdown files. Edit them directly:
|
||||||
```bash
|
```bash
|
||||||
nano .opencode/agent/core/opencoder.md # local project install
|
nano .opencode/agent/core/opencoder.md # local project install
|
||||||
# Or: nano ~/.config/opencode/agent/core/opencoder.md # global install
|
# Or: nano ~/.config/opencode/agent/core/opencoder.md # global install
|
||||||
|
|
@ -627,7 +627,7 @@ Agents automatically use updated patterns.
|
||||||
|
|
||||||
## 🎯 Is This For You?
|
## 🎯 Is This For You?
|
||||||
|
|
||||||
### ✅ Use AOC if you:
|
### ✅ Use OAC if you:
|
||||||
- Build production code that ships without heavy rework
|
- Build production code that ships without heavy rework
|
||||||
- Work in a team with established coding standards
|
- Work in a team with established coding standards
|
||||||
- Want control over agent behavior (not black-box plugins)
|
- Want control over agent behavior (not black-box plugins)
|
||||||
|
|
@ -636,7 +636,7 @@ Agents automatically use updated patterns.
|
||||||
- Want repeatable, consistent results
|
- Want repeatable, consistent results
|
||||||
- Use multiple AI models (no vendor lock-in)
|
- Use multiple AI models (no vendor lock-in)
|
||||||
|
|
||||||
### ⚠️ Skip AOC if you:
|
### ⚠️ Skip OAC if you:
|
||||||
- Want fully autonomous execution without approval gates
|
- Want fully autonomous execution without approval gates
|
||||||
- Prefer "just do it" mode over human-guided workflows
|
- Prefer "just do it" mode over human-guided workflows
|
||||||
- Don't have established coding patterns yet
|
- Don't have established coding patterns yet
|
||||||
|
|
@ -648,14 +648,14 @@ Agents automatically use updated patterns.
|
||||||
**Try this test:**
|
**Try this test:**
|
||||||
1. Ask your current AI tool to generate an API endpoint
|
1. Ask your current AI tool to generate an API endpoint
|
||||||
2. Count how many minutes you spend refactoring it to match your patterns
|
2. Count how many minutes you spend refactoring it to match your patterns
|
||||||
3. If you're spending time on refactoring, AOC will save you that time
|
3. If you're spending time on refactoring, OAC will save you that time
|
||||||
|
|
||||||
**Or ask yourself:**
|
**Or ask yourself:**
|
||||||
- Do you have coding standards your team follows?
|
- Do you have coding standards your team follows?
|
||||||
- Do you spend time refactoring AI-generated code?
|
- Do you spend time refactoring AI-generated code?
|
||||||
- Do you want AI to follow YOUR patterns, not generic ones?
|
- Do you want AI to follow YOUR patterns, not generic ones?
|
||||||
|
|
||||||
If you answered "yes" to any of these, AOC is for you.
|
If you answered "yes" to any of these, OAC is for you.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -726,15 +726,15 @@ A: Run `/add-context --update` anytime your patterns change. Agents automaticall
|
||||||
### Comparison
|
### Comparison
|
||||||
|
|
||||||
**Q: How is this different from Cursor/Copilot?**
|
**Q: How is this different from Cursor/Copilot?**
|
||||||
A: AOC has editable agents (not baked-in), approval gates (not auto-execute), context system (YOUR patterns), and MVI token efficiency.
|
A: OAC has editable agents (not baked-in), approval gates (not auto-execute), context system (YOUR patterns), and MVI token efficiency.
|
||||||
|
|
||||||
**Q: How is this different from Aider?**
|
**Q: How is this different from Aider?**
|
||||||
A: AOC has team patterns, context system, approval workflow, and smart pattern discovery. Aider is file-based only.
|
A: OAC has team patterns, context system, approval workflow, and smart pattern discovery. Aider is file-based only.
|
||||||
|
|
||||||
**Q: How does this compare to Oh My OpenCode?**
|
**Q: How does this compare to Oh My OpenCode?**
|
||||||
A: Both are built on OpenCode. AOC focuses on **control & repeatability** (approval gates, pattern control, team standards). Oh My OpenCode focuses on **autonomy & speed** (parallel agents, auto-execution). [Read detailed comparison →](https://github.com/darrenhinde/OpenAgentsControl/discussions/116)
|
A: Both are built on OpenCode. OAC focuses on **control & repeatability** (approval gates, pattern control, team standards). Oh My OpenCode focuses on **autonomy & speed** (parallel agents, auto-execution). [Read detailed comparison →](https://github.com/darrenhinde/OpenAgentsControl/discussions/116)
|
||||||
|
|
||||||
**Q: When should I NOT use AOC?**
|
**Q: When should I NOT use OAC?**
|
||||||
A: If you want fully autonomous execution without approval gates, or if you don't have established coding patterns yet.
|
A: If you want fully autonomous execution without approval gates, or if you don't have established coding patterns yet.
|
||||||
|
|
||||||
### Setup
|
### Setup
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue