skills/codex-spec-interviewer/assets/spec-template.compact.md

---
title: "<short human-readable title>"
slug: "<kebab-case-slug>"
artifact_path: "docs/specs/<kebab-case-slug>-spec.md"
mode: "compact"
status: "draft"
owner: "<person-or-team>"
repo: "<repo-name-or-path>"
created: "YYYY-MM-DD"
updated: "YYYY-MM-DD"
source_request: "<original request>"
---

# <title>

## Goal

<one paragraph describing the change and the user-visible outcome>

## Scope

- In scope:
- Out of scope:

## Repo context

- Relevant files or areas:
- Existing commands or conventions:
- Unknown repo facts marked as unspecified:

## Requirements

### Functional requirements

- WHEN <condition/event>, THE SYSTEM SHALL <expected behavior>.
- WHEN <condition/event>, THE SYSTEM SHALL <expected behavior>.

### Constraints

- Keep/change:
- Must not:
- Compatibility/performance/security constraints:

## File plan

- Update:
- Add:
- Avoid touching:

## Architectural decisions

- ADR required: yes/no/unresolved
- Existing ADRs consulted:
- ADR draft or path:
- Implementation blocked until ADR accepted: yes/no

## Source challenge

- Repo evidence checked:
- ADRs/specs checked:
- External docs checked or skipped:
- Requirements revised:
- Requirements preserved:
- ADR gate result:

## Validation

```bash
<lint command or "unspecified">
<test command or "unspecified">
<manual verification step>
```

## Done when

- [ ] Behavior matches the request
- [ ] Relevant checks pass
- [ ] No stated non-goal was implemented

## Assumptions and open questions

- Assumption:
- Open question: