Files
lucidia-earth/.trinity/greenlight/docs/GREENLIGHT_CLAUDE_QUICK_REFERENCE.md
Alexa Louise 19dc467aff 🌈 Add Light Trinity system (RedLight + GreenLight + YellowLight)
Complete deployment of unified Light Trinity system:

🔴 RedLight: Template & brand system (18 HTML templates)
💚 GreenLight: Project & collaboration (14 layers, 103 templates)
💛 YellowLight: Infrastructure & deployment
🌈 Trinity: Unified compliance & testing

Includes:
- 12 documentation files
- 8 shell scripts
- 18 HTML brand templates
- Trinity compliance workflow

Built by: Cece + Alexa
Date: December 23, 2025
Source: blackroad-os/blackroad-os-infra
🌸
2025-12-23 15:49:37 -06:00

322 lines
7.0 KiB
Markdown

# 🛣️ GreenLight Quick Reference for Claude Agents
**One-page cheat sheet for using GreenLight in BlackRoad memory system**
---
## 🚀 Quick Start
```bash
# Load GreenLight templates
source ~/memory-greenlight-templates.sh
# Announce work
gl_announce "claude-yourname" "Project Name" "1) Task 2) Task 3) Task" "Big Goal" "🎢" "🔧" "⭐"
# Update progress
gl_progress "claude-yourname" "What you finished" "What's next" "👉" "🔧"
# Log deployment
gl_deploy "service-name.blackroad.io" "https://url" "Details" "👉" "🔧"
```
---
## 📊 Common GreenLight Patterns
### For Announcements
```
🎯🎢🛣️🔥 = Targeted macro platform project, fire priority
🎯👉🌀⭐ = Targeted micro AI task, high priority
🎯🎢🔧📌 = Targeted macro infra project, medium priority
```
### For Progress
```
✅👉🛣️ = Done micro platform task
✅🎢🔧 = Done macro infra project
🚧👉🌀 = WIP micro AI task
```
### For Coordination
```
🤝⭐💬 = Coordinate high priority
🤝📌💬 = Coordinate medium priority
```
### For Blocking
```
🔒🔥⛔ = Blocked fire priority
🔒⭐⛔ = Blocked high priority
```
### For Deployment
```
🚀👉🔧✅ = Deployed micro infra, done
🚀🎢🛣️✅ = Deployed macro platform, done
```
---
## 🎯 Phase Markers
Use these for project phases:
| Emoji | Phase | When to Use |
|-------|-------|-------------|
| 🌱 | DISCOVERY | Researching, exploring, learning |
| 📐 | PLANNING | Designing, architecting, strategy |
| 🔨 | IMPLEMENTATION | Building, coding, executing |
| 🧪 | TESTING | QA, validation, verification |
| 🚀 | DEPLOYMENT | Shipping, launching, releasing |
| 📊 | MONITORING | Observing, measuring, optimizing |
| 🔄 | ITERATION | Improving, refining, evolving |
**Examples:**
```bash
gl_phase_start "planning" "API Service" "Designing endpoints" "🎢"
gl_phase_done "implementation" "Frontend" "All components built" "🎢"
```
---
## 🎨 Scale Indicators
| Emoji | Scale | Use For |
|-------|-------|---------|
| 👉 | MICRO | Single task, commit, bug fix |
| 🎢 | MACRO | Project, sprint, feature |
| 🌐 | PLANETARY | System, infrastructure, org-wide |
| 🌌 | UNIVERSAL | Cross-org, federation, external |
---
## 🏷️ Domain Tags
**Most Common:**
| Emoji | Domain | Use For |
|-------|--------|---------|
| 🛣️ | PLATFORM | Core BlackRoad OS |
| 🌀 | AI | Lucidia, agents, ML |
| ⛓️ | CHAIN | RoadChain, blockchain |
| 💎 | COIN | RoadCoin, tokens |
| 🔧 | INFRA | Infrastructure, DevOps |
| 🎨 | CREATIVE | Design, art |
| 📊 | DATA | Analytics, BI |
| 🔒 | SECURITY | Auth, encryption |
---
## ⚡ Priority Levels
| Emoji | Priority | When |
|-------|----------|------|
| 🔥 | FIRE (P0) | DROP EVERYTHING |
| 🚨 | URGENT (P1) | Today |
| ⭐ | HIGH (P2) | This week |
| 📌 | MEDIUM (P3) | This sprint |
| 💤 | LOW (P4) | Someday |
| 🧊 | ICE (P5) | Frozen |
---
## 🤖 Agent Identities
| Emoji | Agent | Role |
|-------|-------|------|
| 🌸 | CECE | Primary reasoning (Claude) |
| 🔮 | LUCIDIA | Recursive AI |
| 🐇 | ALICE | Edge agent (Pi) |
| 🎸 | SILAS | Creative (Grok) |
| 🌙 | ARIA | Multimodal (Gemini) |
| 🎩 | CADDY | General (GPT) |
| 🦊 | EDGE | Privacy (Ollama) |
| 🐙 | SWARM | Agent collective |
---
## 📝 Template Cheat Sheet
### Announce Work
```bash
gl_announce "agent-name" "project" "tasks" "goal" "scale" "domain" "priority"
```
### Progress Update
```bash
gl_progress "agent-name" "completed" "next" "scale" "domain"
```
### Coordinate
```bash
gl_coordinate "from-agent" "to-agent" "message" "priority"
```
### Blocked
```bash
gl_blocked "agent-name" "reason" "needs" "priority"
```
### Deploy
```bash
gl_deploy "service" "url" "details" "scale" "domain"
```
### Decision
```bash
gl_decide "topic" "decision" "rationale" "scale"
```
### Bug
```bash
gl_bug "component" "description" "priority" "scale"
```
### Feature
```bash
gl_feature "name" "description" "effort" "priority"
```
### Phase Start
```bash
gl_phase_start "phase" "project" "details" "scale"
```
### Phase Done
```bash
gl_phase_done "phase" "project" "summary" "scale"
```
### WIP
```bash
gl_wip "task" "status" "agent" "scale"
```
### Dependency
```bash
gl_depends "task" "depends-on" "reason"
```
---
## 💡 Real Examples
### Starting New Work
```bash
source ~/memory-greenlight-templates.sh
gl_announce "claude-api" \
"FastAPI Backend" \
"1) Database schema 2) Auth endpoints 3) CRUD APIs 4) Deploy to Cloudflare" \
"BlackRoad SaaS API layer" \
"🎢" "🔧" "⭐"
```
**Result:** `[🎯🎢🔧⭐📣] Working on: FastAPI Backend...`
### Updating Progress
```bash
gl_progress "claude-api" \
"Database schema migrated, auth endpoints done" \
"Building CRUD APIs" \
"👉" "🔧"
```
**Result:** `[✅👉🔧] Completed: Database schema migrated...`
### Coordinating
```bash
gl_coordinate "claude-frontend" "claude-api" \
"Need your API base URL and auth callback endpoint for CORS setup" \
"⭐"
```
**Result:** `[🤝⭐💬] @claude-api: Need your API base URL...`
### Deploying
```bash
gl_deploy "api.blackroad.io" \
"https://api.blackroad.io" \
"FastAPI + PostgreSQL, OAuth2, Port 8080" \
"🎢" "🔧"
```
**Result:** `[🚀🎢🔧✅] URL: https://api.blackroad.io. FastAPI...`
### Starting Phase
```bash
gl_phase_start "implementation" \
"BlackRoad API" \
"Building core CRUD endpoints and auth flow" \
"🎢"
```
**Result:** `[🚧🔨🎢⏰] Starting implementation phase...`
### Completing Phase
```bash
gl_phase_done "testing" \
"BlackRoad API" \
"All integration tests passing, load tested to 1000 RPS" \
"🎢"
```
**Result:** `[✅🧪🎢🎉] Completed testing phase...`
---
## 🔍 Reading GreenLight Tags
When you see an entry like `[🚧👉🌀⭐🌸]`, read it as:
- 🚧 = WIP (work in progress)
- 👉 = MICRO (small task)
- 🌀 = AI (AI domain)
- ⭐ = HIGH (high priority)
- 🌸 = CECE (assigned to Cece)
**Translation:** "Cece is actively working on a high-priority micro AI task"
---
## 📚 Full Dictionary
For the complete emoji reference:
```bash
cat ~/GREENLIGHT_EMOJI_DICTIONARY.md
```
For template help:
```bash
~/memory-greenlight-templates.sh help
```
---
## ✅ Integration with Memory
All GreenLight templates automatically log to the BlackRoad memory system with proper tags:
```bash
# Check recent GreenLight entries
tail -10 ~/.blackroad/memory/journals/master-journal.jsonl | jq -r '.details'
# Filter by phase
grep "🔨" ~/.blackroad/memory/journals/master-journal.jsonl | jq -r '.entity + ": " + .details'
# Filter by priority
grep "🔥" ~/.blackroad/memory/journals/master-journal.jsonl | jq -r '.entity + ": " + .details'
```
---
## 🎯 The Vision
**No more Jira. No more Asana. No more ClickUp.**
Every Claude agent speaks the same visual language.
Every status is instantly recognizable.
Every project phase is tracked with emoji precision.
**GreenLight IS BlackRoad.** 🛣️
---
**Created:** December 23, 2025
**For:** All Claude Agents
**Version:** 1.0.0