Project Structure

🏗️ Project Structure

Architecture Overview

graph TD
    CLI[Cli Layer] --> P[Pipeline Layer]
    P --> S[Steps Layer]
    S --> CL[Claude Layer]
    P --> CF[Config Layer]
    P --> UI[UI Layer]

    CLI --> |RunCommand<br/>RunPipelineCommand| P
    P --> |PipelineExecutor<br/>PipelineContext| S
    S --> |DynamicStep<br/>ForeachStep<br/>ParallelStep<br/>UsePipelineStep| CL
    CL --> |ClaudeCliRunner<br/>IClaudeRunner| EXT["☁️ Claude Code CLI"]

Loading

---

📁 Source Tree

code-genesis/
│
├── 📄 Solution.slnx
├── 📄 README.md
├── 📄 global.json                         # Pins .NET SDK version (10.0.103)
│
├── 🔧 .github/
│   └── workflows/
│       └── ci.yml                          # GitHub Actions CI pipeline
│
├── 📁 examples/
│   ├── hello-world.yml                     # Sample pipeline
│   ├── foreach-parallel.yml                # Foreach + parallel demo
│   ├── parallel-foreach.yml                # Parallel foreach demo
│   ├── approval.yml                        # Approval step demo
│   ├── fail-if-step.yml                    # fail_if post-check demo
│   ├── use-pipeline/                       # Pipeline composition demo
│   │   ├── main.yml                        # Parent pipeline
│   │   └── analysis.yml                    # Reusable child pipeline
│   └── contexts/planner/                   # Sample context bundle
│
├── 🧬 CodeGenesis.Engine/                  # Main project
│   ├── Program.cs                          # Entry point, DI, Serilog, Spectre CLI
│   │
│   ├── 🤖 Claude/                          # Claude CLI integration
│   │   ├── IClaudeRunner.cs                # Abstraction for testability
│   │   ├── ClaudeCliRunner.cs              # Spawns claude --print processes
│   │   ├── ClaudeCliOptions.cs             # Configuration POCO
│   │   ├── ClaudeRequest.cs                # Request model
│   │   └── ClaudeResponse.cs               # Response model + JSON parsing
│   │
│   ├── 💻 Cli/                             # CLI commands
│   │   ├── RunCommand.cs                   # run (hardcoded pipeline)
│   │   └── RunPipelineCommand.cs           # run-pipeline (YAML-driven)
│   │
│   ├── 📋 Config/                          # Configuration & models
│   │   ├── PipelineConfig.cs               # YAML deserialization models
│   │   ├── PipelineConfigLoader.cs         # YAML loader + template resolver
│   │   ├── ContextBundleLoader.cs          # Context bundles from directories
│   │   ├── AgentDefinition.cs              # Agent config model
│   │   ├── McpServerConfig.cs              # MCP stdio server config
│   │   ├── McpContextBuilder.cs            # Builds MCP tools section for system prompt
│   │   └── MarkdownFrontmatterParser.cs    # YAML frontmatter from .md files
│   │
│   ├── 🔄 Pipeline/                        # Core pipeline framework
│   │   ├── PipelineExecutor.cs             # Runs steps sequentially
│   │   ├── PipelineContext.cs              # Shared state between steps
│   │   ├── IPipelineStep.cs                # Step interface
│   │   ├── IStepExecutor.cs                # Interface for recursive execution
│   │   ├── CollectionParser.cs             # JSON/CSV/newline collections
│   │   ├── StepResult.cs                   # Step output model
│   │   ├── RetryPolicy.cs                  # Retry configuration resolution
│   │   └── CheckpointManager.cs            # Resume/checkpoint persistence
│   │
│   ├── ⚡ Steps/                            # Step implementations
│   │   ├── DynamicStep.cs                  # YAML-driven dynamic step
│   │   ├── ForeachStep.cs                  # Sequential iteration
│   │   ├── ParallelStep.cs                 # Concurrent branches
│   │   ├── ParallelForeachStep.cs          # Concurrent iteration
│   │   ├── ApprovalStep.cs                 # Interactive approval
│   │   ├── UsePipelineStep.cs              # Pipeline composition (sub-pipeline)
│   │   ├── StepBuilder.cs                  # Builds step trees from YAML
│   │   ├── PlanStep.cs                     # Built-in planning step
│   │   ├── ExecuteStep.cs                  # Built-in execution step
│   │   └── ValidateStep.cs                 # Built-in validation step
│   │
│   └── 🎨 UI/                              # Console rendering
│       ├── PipelineRenderer.cs             # Spectre.Console output
│       └── ConsoleTheme.cs                 # Theme constants
│
└── 🧪 CodeGenesis.Engine.Tests/            # Unit tests
    ├── Claude/
    │   └── ClaudeResponseTests.cs
    ├── Config/
    │   ├── McpServerConfigTests.cs
    │   ├── McpContextBuilderTests.cs
    │   ├── PipelineConfigLoaderTests.cs
    │   └── StepEntryTests.cs
    ├── Pipeline/
    │   ├── CollectionParserTests.cs
    │   ├── PipelineContextTests.cs
    │   ├── RetryPolicyTests.cs
    │   └── StepResultTests.cs
    └── Steps/
        ├── DynamicStepTests.cs
        └── UsePipelineStepTests.cs

---

🧱 Key Design Patterns

Pattern	Where	Description
Dependency Injection	Program.cs	All services registered via Microsoft.Extensions.DependencyInjection
Template Resolution	PipelineConfigLoader	{{variable}} syntax resolved before each step
Step Composition	StepBuilder	Recursive tree built from YAML config
Async/Cancellation	All steps	CancellationToken propagated, Ctrl+C handled
Retry with Backoff	DynamicStep	Configurable retry for timeouts, rate limit pauses for 429s
Interface Abstraction	IClaudeRunner, IStepExecutor	Enables unit testing with mocks