Create Specification File

Create Specification File

Repository continuity composition

For repository-scoped work, compose maintain-repository-continuity in Resume mode before selecting work. After an authorized repository change passes domain validation, compose Refresh and Verify immediately before presenting the pull request, and include the reconciled root CONTINUITY.md in the same change. A policy-permitted no-change or exemption result must be documented instead of fabricating an edit.

• Contribute: Requirements, boundaries, acceptance criteria, validation, and unresolved decisions
• Never claim: That specified work is implemented or open decisions are resolved without evidence

Purpose

Execute the reusable procedure governed by specfile.

Primary question:

What implementation contract is required, and how will conformance be validated?

Required Inputs

Resolve:

• governing specification and version
• current source or repository state
• scope and constraints
• upstream architecture or evidence
• output location
• validation expectations
• unresolved decisions

Missing evidence must remain visible.

Workflow

1. gather source context and identify the problem
2. separate facts, decisions, assumptions, and proposals
3. define purpose, goals, and non-goals
4. choose type and canonical ownership
5. define requirements, architecture, interfaces, and dependencies
6. organize implementation work into bounded phases
7. define validation and acceptance criteria
8. record risks, edge cases, and open questions
9. validate against the specification standard

Output Contract

Primary output:

<artifact-id>.spec.md

Also report assumptions, evidence gaps, validation status, unresolved questions, and downstream actions requiring separate authorization.

Constraints

• Follow the governing specification.
• Preserve provenance and uncertainty.
• Do not invent authority, evidence, or current behavior.
• Do not silently expand scope.
• Do not claim completion when required validation is missing.
• Keep proposed downstream work separate from authorized execution.

Completion Criteria

• Governing specification is resolved.
• Scope and constraints are explicit.
• Required evidence was inspected.
• The primary output was created.
• Validation was executed or its absence documented.
• Open questions and authorization needs are visible.

Staged Variant

A staged candidate at .staging/skills/spec-authoring/ covers similar ground under the name spec-authoring. The canonical skill is named create-specification-file and is governed by the specfile specification.

Issue 016 should compare the two and extract any unique workflow guidance, template detail, or example material from the staged copy before retiring it. Do not copy the staged file wholesale into canonical source.