docs(rebrand): rename & rebrand CI → CIAgent across all documentation, templates, and scripts
- README.md: title, project name, CLI commands, .ci/ → .ciagent/, ci-files → ciagent-files, CI Modification → CIAgent Modification - AGENTS.md: title, project name, architecture tree, agent count (18→19), test count (25→31 suites, 218→370 tests), version (0.4.0→0.6.0), ci-files → ciagent-files, CIConfig → CIAgentConfig, CiMetadata → CIAgentMetadata, .ci/ → .ciagent/ - templates/DECISIONS.md: .ci/audit/ → .ciagent/audit/, ci audit → ciagent audit - scripts/postinstall.js: CI postinstall → CIAgent postinstall - scripts/install.sh: CI → CIAgent, ci-init → ciagent-init, INSTALL COMPLETE banner - opencode/ci/workflows/*.md (11 files): .ci/ → .ciagent/, CI → CIAgent project name, ci-command → ciagent-command usage lines - opencode/ci/references/*.md (5 files): .ci/ → .ciagent/, CI → CIAgent project name, ci-files → ciagent-files references - opencode/ci/contexts/*.md (3 files): .ci/ → .ciagent/, CI → CIAgent project name - opencode/agents/ci-*.md (18 files): .ci/ → .ciagent/, CI → CIAgent project name - opencode/command/ci-*.md (11 files): CI → CIAgent project name Preserved: ---ci---/---/ci--- markers, opencode/ci/ dir paths, ci-*.md filenames, ci listProjects()/ci setActiveProject() API names, repo URLs ---ci--- phase: 1 milestone: v0.6 plan: 01-01 task: 01-01-01 status: execute ---/ci---
This commit is contained in:
Jon Chery
@@ -1,10 +1,10 @@
|
||||
# CI — Continuous Intelligence
|
||||
# CIAgent — Continuous Intelligence
|
||||
|
||||
Fully autonomous, git-native AI-driven software engineering harness.
|
||||
|
||||
## Overview
|
||||
|
||||
CI (Continuous Intelligence) is an autonomous-first software engineering harness that eliminates human-in-the-loop overhead while preserving the rigor of guided development. It receives a specification, resolves ambiguities through a single Clarify phase, then executes the full pipeline — research, plan, execute, verify — autonomously.
|
||||
CIAgent (Continuous Intelligence) is an autonomous-first software engineering harness that eliminates human-in-the-loop overhead while preserving the rigor of guided development. It receives a specification, resolves ambiguities through a single Clarify phase, then executes the full pipeline — research, plan, execute, verify — autonomously.
|
||||
|
||||
**The git log IS the project memory.** Every decision, escalation, lesson learned, and verification result is encoded in commit messages using structured `---ci---` YAML blocks. An agent's first impulse to gather context is `git log`, not file reads. Another agent with access to only commit messages (no code, no diffs) can reconstruct the project state completely.
|
||||
|
||||
@@ -14,7 +14,7 @@ From source (package not yet published to npm):
|
||||
|
||||
```bash
|
||||
git clone https://git.cloudinit.dev/continuous-intelligence/ci.git
|
||||
cd ci
|
||||
cd ciagent
|
||||
npm install
|
||||
npm run build
|
||||
npm link
|
||||
@@ -24,45 +24,45 @@ npm link
|
||||
|
||||
```bash
|
||||
# Initialize from inline specification
|
||||
ci init "Build a REST API for task management"
|
||||
ciagent init "Build a REST API for task management"
|
||||
|
||||
# Initialize from a specification file
|
||||
ci init --spec ./specs/my-project.md
|
||||
ciagent init --spec ./specs/my-project.md
|
||||
|
||||
# Run the full autonomous pipeline
|
||||
ci run --all
|
||||
ciagent run --all
|
||||
|
||||
# Run a specific phase
|
||||
ci run research
|
||||
ci run plan
|
||||
ci run execute
|
||||
ci run verify
|
||||
ciagent run research
|
||||
ciagent run plan
|
||||
ciagent run execute
|
||||
ciagent run verify
|
||||
|
||||
# Execute an ad-hoc task
|
||||
ci quick "Add authentication middleware"
|
||||
ciagent quick "Add authentication middleware"
|
||||
|
||||
# Check project status (reads from git log + branches)
|
||||
ci status
|
||||
ciagent status
|
||||
|
||||
# Review autonomous decisions (extracted from git log ---ci--- blocks)
|
||||
ci audit
|
||||
ci audit --verbose
|
||||
ciagent audit
|
||||
ciagent audit --verbose
|
||||
|
||||
# Debug an issue
|
||||
ci debug "Tests failing on CI"
|
||||
ciagent debug "Tests failing on CI"
|
||||
|
||||
# Rollback a phase
|
||||
ci rollback 1
|
||||
ciagent rollback 1
|
||||
|
||||
# Ship a phase (verify, security, commit, tag)
|
||||
ci ship 1
|
||||
ciagent ship 1
|
||||
```
|
||||
|
||||
## Git-Native Architecture (v0.2.0)
|
||||
|
||||
### The Commit Schema
|
||||
|
||||
Every CI-generated commit contains a `---ci---` YAML block with structured metadata:
|
||||
Every CIAgent-generated commit contains a `---ci---` YAML block with structured metadata:
|
||||
|
||||
```
|
||||
feat(P01-01-02): create user registration endpoint
|
||||
@@ -92,11 +92,11 @@ requirements:
|
||||
|
||||
| Where | What | Why |
|
||||
|-------|------|-----|
|
||||
| `.ci/config.json` | Autonomy, thresholds, git strategy | Controls system behavior before any commits exist |
|
||||
| `.ci/PROJECT.md` | Vision, core value, requirements, constraints, key decisions table | Long-lived strategic reference |
|
||||
| `.ci/ARCHITECTURE.md` | System architecture, component boundaries, data flow | Long-lived technical reference |
|
||||
| `.ci/ROADMAP.md` | Phase breakdown, milestone mapping, success criteria | Long-lived planning reference |
|
||||
| `.ci/REQUIREMENTS.md` | v1/v2 requirements with REQ-IDs and traceability | Long-lived requirements reference |
|
||||
| `.ciagent/config.json` | Autonomy, thresholds, git strategy | Controls system behavior before any commits exist |
|
||||
| `.ciagent/PROJECT.md` | Vision, core value, requirements, constraints, key decisions table | Long-lived strategic reference |
|
||||
| `.ciagent/ARCHITECTURE.md` | System architecture, component boundaries, data flow | Long-lived technical reference |
|
||||
| `.ciagent/ROADMAP.md` | Phase breakdown, milestone mapping, success criteria | Long-lived planning reference |
|
||||
| `.ciagent/REQUIREMENTS.md` | v1/v2 requirements with REQ-IDs and traceability | Long-lived requirements reference |
|
||||
| **Git commit bodies** | Decisions, escalations, lessons, compounds, verification results | Dynamic event stream — the audit trail |
|
||||
| **Git branches** | Phase/milestone status | `phase/NN-slug` and `milestone/vX.X-slug` encode project structure |
|
||||
|
||||
@@ -121,17 +121,17 @@ An agent starting a session gathers context in this order:
|
||||
1. `git log --oneline -20` — recent activity
|
||||
2. `git branch -a` — phase/milestone structure
|
||||
3. `git log -1 --format="%b"` — latest `---ci---` block
|
||||
4. `.ci/config.json` — autonomy + thresholds
|
||||
5. `.ci/PROJECT.md` — vision + constraints (when needed)
|
||||
6. `.ci/ROADMAP.md` — phase plan + success criteria (when needed)
|
||||
7. `.ci/REQUIREMENTS.md` — REQ-IDs + traceability (when planning)
|
||||
8. `.ci/ARCHITECTURE.md` — system structure (when researching)
|
||||
4. `.ciagent/config.json` — autonomy + thresholds
|
||||
5. `.ciagent/PROJECT.md` — vision + constraints (when needed)
|
||||
6. `.ciagent/ROADMAP.md` — phase plan + success criteria (when needed)
|
||||
7. `.ciagent/REQUIREMENTS.md` — REQ-IDs + traceability (when planning)
|
||||
8. `.ciagent/ARCHITECTURE.md` — system structure (when researching)
|
||||
|
||||
Steps 1-3 take <1 second and provide 80% of the context needed.
|
||||
|
||||
### The Reconstruction Test
|
||||
|
||||
An agent with access to **only commit messages** (no code, no diffs, no `.ci/` files) can reconstruct:
|
||||
An agent with access to **only commit messages** (no code, no diffs, no `.ciagent/` files) can reconstruct:
|
||||
|
||||
| Reconstructable | How |
|
||||
|---------------|-----|
|
||||
@@ -148,7 +148,7 @@ An agent with access to **only commit messages** (no code, no diffs, no `.ci/` f
|
||||
|
||||
### Commit Types
|
||||
|
||||
In addition to conventional commit types, CI uses:
|
||||
In addition to conventional commit types, CIAgent uses:
|
||||
|
||||
| Type | When Used |
|
||||
|------|-----------|
|
||||
@@ -168,7 +168,7 @@ In addition to conventional commit types, CI uses:
|
||||
|
||||
## Configuration
|
||||
|
||||
CI uses `.ci/config.json` for project configuration:
|
||||
CIAgent uses `.ciagent/config.json` for project configuration:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -224,7 +224,7 @@ SPECIFY → CLARIFY → RESEARCH → PLAN → EXECUTE → VERIFY → COMPLETE
|
||||
| `commit-builder` | Structured commit message generation for all commit types |
|
||||
| `git-context` | Project state reconstruction from `git log` + `git branch` |
|
||||
| `git-branch` | Phase/milestone branch lifecycle management |
|
||||
| `ci-files` | `.ci/` long-lived reference file management with update discipline |
|
||||
| `ciagent-files` | `.ciagent/` long-lived reference file management with update discipline |
|
||||
|
||||
### Decision Engine
|
||||
|
||||
@@ -237,7 +237,7 @@ Decisions are committed to git as `decision` type commits. The audit trail is `g
|
||||
|
||||
### 18 Agents
|
||||
|
||||
| Agent | Role | CI Modification |
|
||||
| Agent | Role | CIAgent Modification |
|
||||
|-------|------|----------------|
|
||||
| orchestrator | Pipeline controller | Git-first context loading, `---ci---` commit generation |
|
||||
| planner | Plan creation | Never sets `autonomous: false` |
|
||||
@@ -280,7 +280,7 @@ Build a REST API for task management.
|
||||
|
||||
## Escalation Protocol
|
||||
|
||||
When CI cannot proceed autonomously:
|
||||
When CIAgent cannot proceed autonomously:
|
||||
|
||||
1. **Irreversible Action**: Deploy, delete, merge to protected branch
|
||||
2. **Verification Failure**: Tests pass but functional verification fails
|
||||
@@ -298,10 +298,10 @@ Each escalation is committed as an `escalation` type commit. Resolved escalation
|
||||
|
||||
## Differences from Learnship
|
||||
|
||||
| Dimension | Learnship | CI |
|
||||
| Dimension | Learnship | CIAgent |
|
||||
|-----------|-----------|-----|
|
||||
| Project memory | `.planning/` directory files (legacy) | Git log + `---ci---` commit blocks |
|
||||
| Audit trail | `.ci/audit/*.json` files (legacy) | `git log --grep="decisions:"` |
|
||||
| Audit trail | `.ciagent/audit/*.json` files (legacy) | `git log --grep="decisions:"` |
|
||||
| State management | `STATE.md` + `STATE.md.json` (legacy) | Reconstructed from git on demand |
|
||||
| Phase discovery | Read `.planning/phases/` directory (legacy) | `git branch -a \| grep phase/` |
|
||||
| Human Interactions | 19+/lifecycle | 1-2/lifecycle |
|
||||
|
||||
Reference in New Issue
Block a user