Gcc

Git Context Controller (GCC)

Overview

GCC transforms agent memory from a passive token stream into a structured, versioned file system under .GCC/. Inspired by Git, it provides four operations — COMMIT, BRANCH, MERGE, CONTEXT — to persist milestones, explore alternatives in isolation, synthesize results, and recover historical context efficiently.

Initialization

On first use, check if .GCC/ exists in the project root. If not, run scripts/gcc_init.sh to create the directory structure:

.GCC/
├── main.md          # Global roadmap and objectives
├── metadata.yaml    # Infrastructure state (branches, file tree, config)
├── commit.md        # Commit history for main branch
├── log.md           # OTA execution log for main branch
└── branches/        # Isolated workspaces for experiments
    └── <branch-name>/
        ├── commit.md
        ├── log.md
        └── summary.md

For detailed file format specifications, read references/file_formats.md.

Configuration

GCC behavior is controlled via metadata.yaml:

• proactive_commits: true — Automatically suggest commits after completing coherent sub-tasks
• proactive_commits: false — Only commit when explicitly requested

Toggle with: "enable/disable proactive commits" or by editing metadata.yaml.

Commands

COMMIT

Persist a milestone on the current branch.

Triggers: /gcc commit <summary>, "commit this progress", "save this milestone", "checkpoint"

Procedure:

1. Read the current branch's commit.md to determine the next commit number
2. Append a new entry to commit.md with:
   • Sequential ID (e.g., [C004])
   • Date (UTC ISO 8601)
   • Current branch name
   • Branch purpose (from summary.md if on a branch, or from main.md)
   • Previous progress summary (1-2 sentences from last commit)
   • This commit's contribution (detailed technical description with files touched)
3. Append an OTA entry to log.md recording the commit action
4. Update metadata.yaml file tree if files were created/modified
5. If on main branch, update milestones section in main.md

Proactive behavior: When proactive_commits: true, suggest a commit after:

• Completing a function, module, or coherent unit of work
• Fixing a bug and verifying the fix
• Finishing a research/exploration phase with conclusions
• Any point where losing context would mean re-doing significant work

BRANCH

Create an isolated workspace for exploring an alternative approach.

Triggers: /gcc branch <name>, "branch to try...", "explore alternative...", "experiment with..."

Procedure:

1. Create .GCC/branches/<branch-name>/ directory
2. Create summary.md with: purpose, parent branch, creation date, key hypotheses
3. Create empty commit.md and log.md for the branch
4. Update metadata.yaml to register the new branch
5. Update main.md Active Branches section
6. Log the branch creation in the parent branch's log.md

From this point, all COMMITs and OTA logs go to the branch-specific files until a MERGE or explicit branch switch.

MERGE

Integrate a completed branch back into the main flow.

Triggers: /gcc merge <branch>, "merge results from...", "integrate the experiment", "branch X is done"

Procedure:

1. Read the branch's summary.md and commit.md to understand outcomes
2. Append a synthesis commit to main's commit.md summarizing:
   • What was tried
   • What was learned
   • What is being integrated (or why the branch is being abandoned)
3. Update main.md:
   • Add milestone entry with branch results
   • Remove from Active Branches
   • Update objectives if applicable
4. Update metadata.yaml: set branch status to merged or abandoned
5. Log the merge in main's log.md