atomic-spec
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Atomic Spec: AI-native agentic methodology for living requirements. DDD + TDD + Use-Case-Driven. One atom, one file, one unit of knowledge.
English | Русский
Atomic Spec 2.0
Portable business requirements, replaceable architecture, executable tests before implementation.
The specification must be sufficient to reproduce the business functionality without
reading the old code. One atom is one *.spec.md with a stable ID. Business domains
are independent of the stack; architecture/ records implementation decisions and constraints.
Workflow: analysis A → Gherkin B → executable tests C / RED →
implementation D / GREEN → acceptance. One agent or a team can perform the roles;
delegation is optional.
Installation
apm install dab512/atomic-spec --target agent-skills
Pinned distribution: GitHub Release v2.0.1, asset atomic-spec-orchestrator-2.0.1.zip. Extract into .agents/skills/.
Getting started
- Read project instructions and related atoms through the registry.
- Start with the business template, assign and register its ID.
- Describe the contract; capture a new independent decision in an architecture atom.
- Pass A/B, write and run RED tests before behavior, then implement GREEN.
- Complete acceptance, update references and record evidence with scope/revision.
Add atomic-spec://SPEC-ID/DR-N comments with explanations while creating code
and independent tests. A configured project Guard takes priority. Otherwise a pinned
Atomic Spec Guard is bundled.
Formal PASS does not establish business correctness; see verification limits.
Documentation
- Методология / Methodology
- Роли / Roles
- Gates
- Формат атома / Atom anatomy
- Архитектура и перенос / Architecture
- Трассируемость / Traceability
- Изменения / Change classification
- VCS
- Правки / Amendments
- Миграция 2.0 / Migration
Development and verification
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements-dev.txt
python -m playwright install chromium
ATOMIC_SPEC_CACHE_DIR="$PWD/.local/guard-cache" bash skills/atomic-spec-orchestrator/scripts/setup-guard.sh
python tools/release.py check
python tools/release.py build
The check command validates links, registry, Guard provenance, real extracted-skill
journeys and page geometry. Missing dependencies and skips are not PASS.
Normative atoms are indexed in specs/registry.json.
Website · Release changes · MIT.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found