specsmith 0.2.2.dev48

Forge governed project scaffolds from the Agentic AI Development Workflow Specification.

specsmith

Governed project scaffolds for AI-assisted development.

Intelligence proposes. Constraints decide. The ledger remembers.

---

The Problem

AI coding agents are powerful but unstructured. Without governance, they skip verification, lose context between sessions, and produce inconsistent results. specsmith generates the governance layer — the rules, verification tools, CI pipelines, and documentation — that makes AI-assisted development auditable and repeatable.

What specsmith Does

For new projects: specsmith init generates a complete project scaffold with governance files, CI/CD, verification tools, and agent integration files tailored to your project type.

For existing projects: specsmith import detects your project's language, build system, and test framework, then generates governance overlay files without modifying your source code. Existing files are preserved.

For ongoing governance: specsmith audit checks health, specsmith export generates compliance reports, specsmith doctor verifies your tools are installed.

Every governed project follows the closed-loop workflow: propose → check → execute → verify → record.

Install

pip install specsmith

Quick Start

# Install
pip install specsmith

# New project (interactive)
specsmith init

# Adopt an existing project
specsmith import --project-dir ./my-project

# Check governance health
specsmith audit --project-dir ./my-project

# Generate architecture docs interactively
specsmith architect --project-dir ./my-project

# Start an AI agent session (universal pattern)
# From any governed repo root:
/agent AGENTS.md

Starting an AI Agent Session

The universal pattern for any specsmith-governed project:

/agent AGENTS.md

This works in Warp, Claude Code, Cursor, and any agent that reads markdown context files. The agent loads AGENTS.md (the governance hub), reads LEDGER.md for session state, and picks up from the last recorded action.

30 Project Types

Software: Python, Rust, Go, C/C++, .NET, JS/TS, mobile, monorepo, microservices, DevOps/IaC, data/ML, browser extensions.

Hardware: FPGA/RTL, Yocto BSP, PCB design, embedded systems.

Documents: Technical specifications, user manuals, research papers, API specifications, requirements management.

Business/Legal: Business plans, patent applications, legal/compliance frameworks.

Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-specific directory structure, governance rules in AGENTS.md, and pre-populated requirements and test stubs.

40+ CLI Commands

Command	Purpose
init	Scaffold a new governed project
import	Adopt an existing project (merge mode)
audit	Drift detection and health checks (--fix to auto-repair)
architect	Interactive architecture generation
validate	Governance file consistency checks
compress	Archive old ledger entries
upgrade	Update governance to new spec version
status	CI/PR/alert status from VCS platform
diff	Compare governance against templates
export	Compliance report with REQ↔TEST coverage
doctor	Check if verification tools are installed
self-update	Update specsmith (channel-aware)
credits	AI credit tracking, analysis, and budgets

7 Agent Integrations

AGENTS.md (cross-platform standard), Warp/Oz, Claude Code, GitHub Copilot, Cursor, Gemini CLI, Windsurf, Aider.

3 VCS Platforms

GitHub Actions, GitLab CI, Bitbucket Pipelines — all with tool-aware CI generated from the verification tool registry. Dependabot/Renovate configured per language ecosystem.

Documentation

specsmith.readthedocs.io — Full user manual with tutorials, command reference, project type details, tool registry, governance model, troubleshooting.

Links

• PyPI
• Documentation
• Changelog
• Contributing
• Specification
• Security

License

MIT — Copyright (c) 2026 BitConcepts, LLC.