Agent Dev Control System

Agent Dev Control System is a local, rule-first control plane for agent-assisted software work. It routes a request, retrieves reusable project assets, loads a PromptOS flow, and applies Sentinel governance before producing task or handoff packs.

The project is intentionally small and dependency-light. It is designed as a public reference implementation, not as a hosted SaaS product or a private delivery archive.

What It Contains

• 01_asset_warehouse/ stores reusable modules, templates, pitfalls, tech stacks, prompts, gates, and Sentinel rules. It also builds local collection indexes with deterministic hash embeddings.
• 02_prompt_os/ stores route-specific prompt and gate flows.
• 03_sentinel_runtime/ compiles plans, runs governance checks, builds task packs, and validates claim/evidence consistency.
• 04_dev_router/ maps a structured task request to the correct execution path.
• devctl.py ties the router, Asset Warehouse, PromptOS, and Sentinel Runtime into one CLI.
• app.py serves a local Web UI and JSON API for asset search, context packs, routing, and index rebuilds.

Quick Start

python -m pytest
python devctl.py assets validate --json
python devctl.py rag rebuild --collection all --json
python devctl.py rag query --collection pitfalls --q "Django login bug csrf" --top-k 5 --json
python devctl.py start --request "Existing Django bug; prepare a Codex handoff task pack" --json --dry-run

Local Web UI:

python app.py --host 127.0.0.1 --port 8765

Open http://127.0.0.1:8765/.

Runtime Flow

request
-> Dev Router
-> Asset Warehouse collection retrieval
-> PromptOS flow loading
-> Sentinel compile_plan / govern / validate / gate_check
-> task_pack / handoff_pack
-> Sentinel Corpus governance chain

The sentinel_core object returned by devctl start --json includes:

context_pack
claim_ledger
evidence_map
claim/evidence consistency
response_gate_decision
validator_guard

Public Boundary

This public version contains generic sample assets and runtime code only. It does not include private run evidence, local project summaries, customer delivery packages, screenshots, database captures, recordings, or generated documents.

The optional corpus RAG tool in 01_asset_warehouse/asset_rag.py defaults to the sample cards in this repository. To index your own material, pass an explicit --source path or set AGENT_DEV_CONTROL_ASSET_SOURCE.

Documentation

• Architecture
• Open-source boundary
• Sentinel Corpus integration

License

MIT