Skip to content

README.md

Latest commit

 

History

History
108 lines (78 loc) · 3.92 KB

README.md

File metadata and controls

108 lines (78 loc) · 3.92 KB

🧬 CodeGenesis

CI .NET Claude Code License: MIT Wiki

A .NET CLI engine that orchestrates multi-step AI pipelines using Claude Code as the execution backend.

Define pipelines in YAML · Compose agents with Markdown bundles · Let Claude handle the rest

Prerequisites

Quick Start

# Clone & build
git clone https://github.com/viamus/code-genesis.git && cd code-genesis
dotnet build

# Run a YAML pipeline
dotnet run --project CodeGenesis.Engine -- run-pipeline examples/hello-world.yml

# Run an ad-hoc task (Plan → Execute → Validate)
dotnet run --project CodeGenesis.Engine -- run "Add retry logic to the HttpClient service"

Pipeline Example

pipeline:
  name: "Code Review"

inputs:
  task:
    description: "What to review"

steps:
  - name: "Plan"
    prompt: "Create a review plan for: {{task}}"
    output_key: "plan"

  - name: "Execute"
    prompt: "Implement the plan: {{steps.plan}}"
    max_turns: 10
    output_key: "result"

  - name: "Validate"
    prompt: "Review: {{steps.result}}"
    optional: true

Use {{variable}} for inputs and {{steps.<key>}} for outputs from previous steps.

MCP Server Tools

Add description and parameters to MCP servers so the LLM knows when and how to use each tool:

settings:
  mcp_servers:
    jira:
      command: "npx"
      args: ["-y", "@anthropic/mcp-jira"]
      description: "Search and manage Jira tickets"
      parameters:
        project_key:
          description: "The Jira project key"
          example: "PROJ-123"
      env:
        JIRA_TOKEN: "{{jira_token}}"

Descriptions and parameters are injected into the system prompt — they are not sent to the Claude CLI config.

Documentation

Full documentation is available in the Wiki:

Page
🚀 Getting Started Prerequisites, installation, first pipeline
💻 CLI Reference run and run-pipeline commands
📋 Pipeline YAML Reference YAML structure, template variables, max_turns
🔀 Step Types Simple, Foreach, Parallel, ParallelForeach, Approval
🔌 MCP Servers Custom tools via MCP stdio protocol
📦 Context Bundles Reusable agent instruction packages
⚙️ Configuration Environment variables, appsettings.json, logs
🏗️ Project Structure Source tree and architecture
🧪 Testing Test project, coverage, CI

Contributing

See CONTRIBUTING.md for guidelines on how to contribute.

License

This project is licensed under the MIT License. See LICENSE for details.