Specifications first
Resolve ambiguity before implementation.
From your first idea to verified software. Build with AI, clear architecture, and human accountability.
Create a project, specify a feature and check your documents. All locally, without an API key.
Installation guide ↗git clone https://github.com/alexsandsouza/spection.git
cd spection
python kit/spection.py init my-app
python kit/spection.py feature my-app account-login
python kit/spection.py check my-appOffline scaffolding. No API keys or automatic deployment.Resolve ambiguity before implementation.
Document decisions and trade-offs.
Verify results through real tests and review.
Every increment connects requirements, design decisions, tasks and actual test evidence.
Install the offline CLI and bootstrap your project.
Understand SDD, architecture and human review.
Follow a practical project from idea to release.
Booking API, document assistant and existing apps.
Models, agents, gateways and retrieval.
Privacy, security, ethics and accountability.
Reusable instructions for coding assistants.
Guia de utilização em português.
Human approval, privacy, security, accessibility and verified evidence are part of every release.
Explore the official SPECTION demonstration application (v0.3.0 - Published on GitHub Pages, CI & Quality Gates Passed): an interactive academic web application and Python/SQLite baseline for managing fictional students (DEMO-0001), complete with SDD documentation, privacy-by-design storage controls and real test evidence.
Published on GitHub Pages: dashboard, DEMO-0001 CRUD, CSV export and privacy controls
Product Brief, PRD, HLD, LLD, ADRs, Feature Specs and full requirement traceability
CI Passed: 5 Python tests, 17 Vitest unit/component tests and 4 Playwright E2E journeys
Follow the open roadmap, propose improvements and contribute.
Roadmap ↗