GECK

A tool for generating macro-prompts, as well as a GitHub Repo framework, for use with Agentic CLI tools like Claude Code, Codex, Cursor, Antigravity, and other LLM-powered development assistants involved in software engineering sensitive to preservation of context across turns.

Contents

• GECK/ - The Garden of Eden Creation Kit protocol specifications (v1.0, v1.1, v1.2)
• geck_generator/ - A GUI/CLI tool to generate GECK project files

---

What is GECK?

GECK (Garden of Eden Creation Kit) is a lightweight protocol that gives CLI-based LLM agents structured memory and task management across sessions. It solves the "context amnesia" problem where AI assistants forget what they were working on between conversations.

The Problem GECK Solves

When working with CLI LLM agents (Claude Code, Aider, Cursor, etc.):

• Each session starts fresh with no memory of previous work
• The AI may repeat mistakes or forget decisions made earlier
• There's no audit trail of what changed and why
• Large projects lose coherence across multiple sessions

How GECK Works

GECK (v1.2) creates a simple folder structure in your project:

your_project/
└── GECK/
    ├── LLM_init.md      # Your project goals and constraints
    ├── GECK_Inst.md     # Instructions for the AI agent
    ├── log.md           # Session history (long-term memory)
    ├── tasks.md         # Current task list (working memory)
    └── env.md           # Environment documentation

At the start of each session, you point the AI to these files. It reads the context, understands what was done before, and continues where it left off.

---

GECK Generator

The GECK Generator is a tool that helps you create LLM_init.md files and initialize GECK folder structures for your projects.

Installation

Option 1: Run from Source (Recommended)

1. Clone this repository:

   git clone https://github.com/crussella0129/GECK.git
   cd GECK

2. Install dependencies:

   pip install -r requirements.txt

3. Run the generator:

   # GUI mode
   python -m geck_generator --gui
   
   # Interactive CLI mode
   python -m geck_generator --cli

Option 2: Install via pip (Development Mode)

git clone https://github.com/crussella0129/GECK.git
cd GECK
pip install -e .

Note: the username in the URL will match yours if you forked as a template. Then run with:

geck-generator --gui

Option 3: Create Desktop/Start Menu Shortcuts

After cloning and installing dependencies, create shortcuts for easy access:

cd GECK

# Create both desktop and start menu shortcuts
python -m geck_generator --install-shortcut

# Or create only desktop shortcut
python -m geck_generator --install-shortcut desktop

# Or create only start menu shortcut
python -m geck_generator --install-shortcut menu

To remove shortcuts:

python -m geck_generator --uninstall-shortcut

Usage

GUI Mode

python -m geck_generator --gui

The GUI provides a tabbed interface to:

1. Enter basic project information (name, repo URL, local path)
2. Select a preset profile (Web App, CLI Tool, Data Science, etc.)
3. Define goals and success criteria
4. Preview and save the generated files

CLI Mode

python -m geck_generator --cli

Interactive prompts guide you through the same process in your terminal.

To create a full GECK folder structure:

python -m geck_generator --cli --init-geck

Quick Generation with Profiles

# List available profiles
python -m geck_generator --list-profiles

# Generate from a profile
python -m geck_generator --profile web_app --project-name "My App" --goal "Build a REST API" -o ./LLM_init.md

---

Using GECK with CLI LLM Agents

Initial Setup

1. Create your project repository and clone it locally

2. Generate LLM_init.md using GECK Generator:

   cd your_project
   python -m geck_generator --gui

   Fill in your project goals, constraints, and success criteria.

3. Start your CLI LLM agent (Claude Code, Aider, etc.) and give it this prompt:

   Read LLM_init.md and initialize the GECK.
   

4. The AI will create the GECK/ folder with all necessary files and summarize its understanding of your project.

Daily Workflow

Starting a session:

Read the GECK files and continue working on the project.

The AI will:

• Read LLM_init.md for goals
• Check log.md for what happened last session
• Review tasks.md for current work items
• Pick up where you left off

During work:

• The AI commits changes incrementally
• Updates tasks.md as work progresses
• Logs significant actions to log.md

Ending a session:

• The AI will update the log with what was accomplished
• Mark tasks complete or note blockers
• State its checkpoint status (CONTINUE/WAIT/ROLLBACK)

Example Session Prompts

# Starting fresh
Read LLM_init.md and initialize the GECK.

# Continuing work
Read the GECK and continue with the next task.

# Checking status
Read tasks.md and summarize what's done and what's remaining.

# After a break
Read the last log entry and remind me where we left off.

Tips for Best Results with GECK Generator

1. Be specific in LLM_init.md - Clear success criteria help the AI know when it's done

2. Use profiles - The GECK Generator profiles include suggested success criteria and constraints for common project types

3. Review log entries - The AI's log entries help you understand its reasoning and catch issues early

4. Trust the checkpoints - When the AI says WAIT, it genuinely needs your input. Don't skip these.

5. Commit the GECK folder - Keep GECK/ in version control so the history is preserved

---

GECK Protocol Versions

Version	Status	Description
v1.2	Current	Added GECK_Inst.md for AI agent instructions
v1.1	Stable	Work modes, simplified file names
v1.0	Legacy	Initial release

See GECK/GECK_Macro_v1.2 for the full protocol specification.

---

Requirements

• Python 3.10+
• tkinter (usually included with Python)
• jinja2
• questionary (for CLI mode)

Install with:

pip install -r requirements.txt

---

License

See LICENSE file.