Skip to content

Suirotciv/Dev-Agent-System

Repository files navigation

Dev-Agent-System

A reusable agent coordination template: shared .agents/STATE.json, role prompts, append-only session and gate artifacts, and stdlib-only Python helpers so you can validate and scaffold without extra dependencies.

Quick start

git clone https://github.com/Suirotciv/Dev-Agent-System.git
cd Dev-Agent-System

python .agents/scripts/bootstrap.py
# or non-interactive:
python .agents/scripts/new-project.py --name "My App" --description "What it does" --output-dir ../my-app

python -m unittest discover
python .agents/scripts/validate-agent-artifacts.py
python .agents/scripts/demo-smoke.py

Documentation

Doc Purpose
GETTING_STARTED.md First-day walkthrough
AGENTS.md Repo commands and layout
QUICK_REFERENCE.md Roles, flow, defaults
MODELS.md Model / context requirements
PROJECT_CONTEXT.md Template identity and decisions
CURSOR.md Using this template in Cursor (models, chats, roles)

Example project state (TaskFlow sample): examples/task-app/.

Video / narrative demo (PixelForge): Dev-Agent-System-Demo/DEMO.md — storyboard, agent artifacts, terminal recording notes.

Requirements

  • Python 3.9+ (helpers use the standard library only)
  • Git recommended (worktrees, hooks)

License

MIT — see LICENSE.

About

This repository provides a lightweight coordination layer for AI coding agents. It is meant to be copied into a real application repo, then used to coordinate orchestrator, feature, verifier, infra, and design-system sessions through a shared `.agents/STATE.json` file.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages