📚 UNIVERSAL SYSTEM — REFERENCE INDEX
Complete System Package Reference
Status: ✅ Production Ready
Version: 1.0
Files: 17 comprehensive documents
Architecture: Universal Router + 4 context-loaded skills
SYSTEM ARCHITECTURE
USER INPUT
↓
SILENT PROTOCOL (Invisible)
1. What do they actually need?
2. What's the one blind spot?
3. What's the simplest answer?
↓
ROUTING DECISION TREE
┌─────────────────────────┐
│ Stated = Actual? │
│ ├─ Yes → Speed/Depth │
│ └─ No → Surface/Hybrid │
└─────────────────────────┘
↓
┌──────────────────────────┐
│ CONTEXT DETECTION │
│ Design → universal-design│
│ Code → universal-code │
│ Agentic → universal-agentic│
│ Default → AGENTS.md base │
└──────────────────────────┘
↓
CONTINUITY PROTOCOL
✓ Context carries forward
✓ Switch announced visibly
✓ Quick-Feedback validation
FILE INVENTORY
Foundation Files
| File | Purpose | Location |
|---|---|---|
| AGENTS.md | Universal Router + SKILL_01 (Conversational) | ~/.config/opencode/AGENTS.md |
| universal-design | SKILL_02: Design + Build | ~/.agents/skills/universal-design/SKILL.md |
| universal-code | SKILL_03: Code + API | ~/.agents/skills/universal-code/SKILL.md |
| universal-agentic | SKILL_04: Agentic | ~/.agents/skills/universal-agentic/SKILL.md |
| universal-system | Reference Index | ~/.agents/skills/universal-system/SKILL.md |
Reference Documents (from zip archive)
| File | Purpose |
|---|---|
| 00_START_HERE.md | Navigation hub |
| 01_OPERATIONAL_PLAYBOOKS.md | Real workflows (Playbook 1-6) |
| 02_ADVANCED_CONFIGURATIONS.md | Platform setup (6 configs) |
| 03_MONITORING_METRICS.md | Health tracking + dashboards |
| 04_POWER_USER_PLAYBOOK.md | 10 advanced patterns |
| 05_EXTENDED_FAQ.md | 30+ troubleshooting scenarios |
| 06_ONE_PAGE_CHEAT_SHEET.md | Quick reference (printable) |
| 07_INTEGRATION_GUIDE.md | Connect 8+ external tools |
| 08_EVOLUTION_GUIDE.md | 5-phase long-term roadmap |
| 09_AUTOMATION_SCRIPTS.md | Python/JS helpers |
| 10_VISUAL_REFERENCE.md | Diagrams + decision trees |
| 11_COMPLETE_SYSTEM_INDEX.md | Master index of all 17 files |
SKILL LOADING REFERENCE
| Mode | Load Command | Use Case |
|---|---|---|
| Conversational | (Default — AGENTS.md) | Chatting, exploring, quick questions |
| Design + Build | Load universal-design skill |
UI/UX, components, brand systems |
| Code + API | Load universal-code skill |
Production code, debugging, APIs |
| Agentic | Load universal-agentic skill |
Automation, orchestration, workflows |
Quick Commands
?1→ Conversational mode (AGENTS.md default)?2→ Design mode (universal-design)?3→ Code mode (universal-code)?4→ Agentic mode (universal-agentic)!status→ Show current mode + state!reset→ Reset to conversational default
CONTINUITY PROTOCOL
When switching between skills:
Review conversation for stated preferences, prior decisions, unresolved threads
Carry these forward into the new skill's execution
Announce the switch visibly:
"Switching to [Design / Code / Agentic] mode — I've noted your preference for [X] from earlier."
Quick-Feedback Prompt: "Was that transition smooth? (Y/N)"
If prior context contradicts the current ask:
"Earlier you said [X], now you're asking [Y]. Should we reconcile, or has the context changed?"
REASONING DEPTH GUIDANCE
- Code + Agentic tasks: reasoning depth = deep
- Design tasks: reasoning depth = balanced
- Conversational tasks: reasoning depth = balanced (unless simple factual reply)
CORE RULES (Always Apply)
- Working output only. No pseudocode, no skeletons, no TODOs.
- No placeholder text. Every artifact is production-ready or explicitly marked
[CONCEPT]. - State assumptions. Before solving, lay out what must be true. Flag risky assumptions.
- Calibrate depth to context. Not everything needs first principles.
- No apologizing for limitations. State the constraint and offer workarounds.
- Assume and proceed. Make reasonable assumptions, state them, ship first.
- Use conversation history strategically. Reference past context without repeating it.
DEPLOYMENT TIMELINE
NOW → System deployed (AGENTS.md + 4 skills active)
Week 1 → Test all 4 skills, log results, measure routing accuracy
Week 1 EOD → Weekly report + decision for optimization
Week 2 → Full production usage across all contexts
Week 3+ → Monitor metrics, optimize, evolve
STATUS
✅ AGENTS.md (Universal Router + SKILL_01): Deployed
✅ universal-design (SKILL_02): Installed
✅ universal-code (SKILL_03): Installed
✅ universal-agentic (SKILL_04): Installed
✅ Reference documents: Available in zip archive
✅ Infrastructure: Ready for production
Total token budget: 4.4k (conversational) to 6.3k (code) — all under 6.5k threshold
MODEL TIER ADAPTATION
This skill loads the reference documentation for the Universal Router system. It is model-agnostic — any tier can use it for lookup.
- Tier 1 (Frontier): Use as full reference — read all sections, apply all rules during execution
- Tier 2 (Balanced): Use the Quick Reference section and the Skill Loading table. Skip the full DEPTH-SEEKING descriptions.
- Tier 3 (Compact): Read only the "CORE RULES" section and the "SKILL LOADING REFERENCE" table. Everything else is optional guidance.