Ralph Agent Swarm v1.0 — GitHub Issues as Source of Truth

Parent Epic: Ralph Agent Swarm v1.0

GitHub Issues = единственный источник правды для всех задач swarm.

Architecture

GitHub Issues (assign:ralph label)   ← SINGLE SOURCE OF TRUTH
    ├── Go proxy polls every 60s (existing)
    ├── Zig swarm_tools.zig = write-through cache
    ├── Oracle reads GitHub API → Telegram
    └── Sub-issues = task decomposition

Sub-Issues

Oracle GitHub Integration (read GitHub API in watchdog loop)
swarm_task_add → GitHub Issues (write-through)
swarm_status → GitHub API (read-through)
Branch protection + CI (after CI green)

Labels

assign:ralph — task assigned to Ralph agent
priority:P0-P3 — priority levels
status:pending/in-progress/completed/failed — task status
swarm:parent — parent epic marker

Principle

If GH_TOKEN not set — everything degrades gracefully to in-memory state. No breakage.

feat(swarm): GitHub Issues = single source of truth — write-through +…

fix(ci): Fix all CI workflows + rename Antigravity Agent to AGENT TRI

Status Update: 4/4 Sub-issues Complete

All sub-issues are now closed:

Oracle GitHub Integration — read GitHub API in watchdog loop #39 Oracle GitHub Integration — merged in PR feat(swarm): GitHub Issues as single source of truth + Oracle Zig watchdog #43
swarm_task_add → GitHub Issues (write-through) #40 swarm_task_add write-through — merged in PR feat(swarm): GitHub Issues as single source of truth + Oracle Zig watchdog #43
swarm_status → GitHub API (read-through) #41 swarm_status read-through — merged in PR feat(swarm): GitHub Issues as single source of truth + Oracle Zig watchdog #43
Branch protection + CI (after CI green) #42 Branch protection + CI — auto-closed by PR docs: Rewrite agent governance — GitHub Issues = source of truth #44, protection enabled

Branch protection on main:

Required status check: Build & Test (strict)
PR required for all merges (0 approvals for solo dev)
No force push, no deletions

Remaining for epic closure:

PROJECT_TOKEN secret for board automation
Railway redeploy with env vars
Decompose TODO 1: Implement Full Trinity Pipeline with Parallel Agent Execution #27 into Sprint 1 sub-issues

🐝 Agent: Swarm | 2026-03-14
📋 Step: 1/4 — tri swarm sync implemented

Action: Added tri swarm sync command (103 LOC)

Polls gh issue list --state open --limit 50
Counts agent-labeled and status-labeled issues
Writes .trinity/swarm_state.json with assigned task
Faculty board now shows 6/6 agents UP

Result: agent_swarm=up, active_faculty=6, swarm=2idle/1busy:1pending

Next: Sub-issues from #38 checklist:

Oracle GitHub Integration
swarm_task_add → GitHub Issues (write-through)
swarm_status → GitHub API (read-through)

φ² + 1/φ² = 3 — The swarm awakens.

feat(swarm): implement tri swarm sync — GitHub→swarm_state.json

feat(swarm): GitHub Issues = single source of truth — write-through +…

fix(ci): Fix all CI workflows + rename Antigravity Agent to AGENT TRI

feat(swarm): implement tri swarm sync — GitHub→swarm_state.json

Parent tracker — all 5 phases complete (#45-#49). Closing.

Navigation Menu

Repository navigation

Ralph Agent Swarm v1.0 — GitHub Issues as Source of Truth #38

Parent Epic: Ralph Agent Swarm v1.0

Architecture

Sub-Issues

Labels

Principle

Status Update: 4/4 Sub-issues Complete

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Ralph Agent Swarm v1.0 — GitHub Issues as Source of Truth #38

Description

Parent Epic: Ralph Agent Swarm v1.0

Architecture

Sub-Issues

Labels

Principle

Activity

gHashTag commented on Mar 9, 2026

Status Update: 4/4 Sub-issues Complete

gHashTag commented on Mar 14, 2026

gHashTag commented on Apr 30, 2026

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions