agentic-software-engineer 0.1.0

Agent-driven software engineering framework — transforms work tickets into code, tests, docs, and deployments through specialized LLM agents.

ASE — Agentic Software Engineer

An agent-driven software engineering framework that transforms work tickets into code, tests, docs, and deployments through specialized LLM agents.

Features

• Specialized Agents — Backend, frontend, testing, security, database, DevOps, docs, and more — each with its own system prompt and model tier.
• MCP Servers — Operativo (runtime state/DB) + Statico (codebase analysis), running as local sub-processes via stdio transport.
• Skills System — Reusable knowledge modules (SKILL.md) injected into agent system prompts.
• Agent Memory — Cross-session persistence so agents remember project observations across runs.
• Model Tiering — Route LLM calls by cost: fast (haiku), balanced (sonnet), deep (opus) — configurable per agent.
• Full Audit Trail — Every LLM call, tool call, and decision is traced with trace_id + span_id.
• Human-in-the-Loop — Configurable review gates (PR, manual, auto-approve).

Quick Start

Install

pip install agentic-software-engineer

Or install from source:

git clone https://github.com/AG4MA/agentic_software_engineer.git
cd agentic_software_engineer
pip install -e ".[dev]"

Usage

# Initialize a project
ase init myproject --path ./myproject

# Start MCP servers
ase start myproject

# Submit a work request
ase submit myproject "Add a PUT /users/:id endpoint"

# Check status
ase status myproject

# View audit trail
ase audit myproject --stats

# Interactive guide
ase guide
ase guide --topic agents

Configuration

ASE is configured via ase.toml in your project root. Run ase guide --topic config for a full reference.

Minimal example:

[project]
name = "my-api"
description = "REST API for user management"
root_path = "."
db_path = ".ase/ase.db"

[llm]
default_model = "anthropic/claude-sonnet-4-20250514"

[agents]
enabled = ["analyzer", "triage", "backend", "testing"]

Architecture

ase submit "Add endpoint"
        │
        ▼
  ┌─────────────┐     ┌──────────────┐
  │ TriageAgent  │────▶│  Scheduler   │
  │  (fast LLM)  │     │  (dep graph) │
  └─────────────┘     └──────┬───────┘
                              │
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
        ┌──────────┐   ┌──────────┐   ┌──────────┐
        │ Backend  │   │ Testing  │   │  Docs    │
        │  Agent   │   │  Agent   │   │  Agent   │
        └────┬─────┘   └────┬─────┘   └────┬─────┘
             │              │              │
             ▼              ▼              ▼
        ┌──────────────────────────────────────┐
        │        MCP Servers (stdio)           │
        │  Operativo (state)  Statico (code)   │
        └──────────────────┬───────────────────┘
                           │
                      ┌────▼────┐
                      │ SQLite  │
                      │  (WAL)  │
                      └─────────┘

Built-in Guide

Run ase guide for an interactive overview, or drill into a specific topic:

ase guide --topic agents    # Agent types, tiers, lifecycle
ase guide --topic skills    # SKILL.md, preloading, registry
ase guide --topic memory    # Cross-session persistence
ase guide --topic tiers     # Model tiering (fast/balanced/deep)
ase guide --topic mcp       # MCP servers
ase guide --topic audit     # Audit & logging
ase guide --topic config    # ase.toml reference
ase guide --topic flow      # Ticket lifecycle

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/ tests/

# Type check
mypy src/ase/

License

MIT