cyberneticlibrary
← library

Initialize new specification

spec-initcommandsetup L1★60
Comamoca/hinoto ↗
What it does

Initialize new project specification with structured requirements

Best for

Creating language-agnostic single-source-of-truth specifications for new projects with enforced contracts and versioning.

Inputs
  • · Project description ($ARGUMENTS)
  • · Existing architecture (optional)
Outputs
  • · spec/README.md (project overview and version)
  • · spec/CHANGELOG.md (version tracking)
  • · spec/contracts/ (API and behavioral specifications)
  • · spec/data-model.md (entities and relationships)
  • · Supporting docs (research.md, quickstart.md)
Requires
  • · File system (write)
  • · Bash (create directory structure)
Preconditions
  • · Project root directory exists
  • · spec/ directory can be created
Failure modes
  • · spec/ already exists → prompts overwrite confirmation
  • · Insufficient description → template provides placeholders
Trust signals
  • · Structured CHANGELOG (semver tracking)
  • · Contracts directory for API/behavioral specs
  • · data-model.md for entity definitions (single source of truth)
  • · Supports multiple languages and frameworks