CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/intent-integrity-kit

Closing the intent-to-code chasm - specification-driven development with BDD verification chain

Overall
score

96%

Does it follow best practices?

Validation for skill structure

Overview
Skills
Evals
Files

clarification-format.mdskills/iikit-02-clarify/references/

Clarification Q&A Format

Format

Each clarification entry follows this pattern:

- Q: <question text> -> A: <answer text> [<ref1>, <ref2>, ...]

References

The bracketed list at the end traces the Q&A back to the spec items it clarifies. Valid reference types:

PrefixMeaningExample
FR-Functional RequirementFR-001
US-User StoryUS-2
SC-Success CriterionSC-003

Every Q&A entry MUST include at least one reference.

Examples

Single reference

- Q: How long should sessions last? -> A: 24 hours with refresh tokens [FR-012]

Multiple references

- Q: How do story cards map to columns? -> A: Columns are Todo / In Progress / Done based on task completion state [FR-001, FR-003, US-2]

New item created by clarification

If the answer leads to creating a new requirement or story, reference the newly created ID:

- Q: Are offline capabilities required? -> A: No, online-only for MVP [FR-015]

Cross-cutting clarification

If the answer affects multiple items across categories:

- Q: Should the pipeline and board share the same data source? -> A: Yes, both read from tasks.md [FR-002, FR-008, US-1, US-3]

Full Section Example

## Clarifications

### Session 2026-02-10

- Q: How do story cards map to columns? -> A: Columns are Todo / In Progress / Done [FR-001, US-2]
- Q: When does the dashboard launch? -> A: Only during implementation phase [FR-005, SC-001]
- Q: When is a story "In Progress" vs "Done"? -> A: Todo = 0 tasks checked. In Progress >= 1. Done = all checked [FR-003, FR-004, US-1]

### Session 2026-02-12

- Q: Should errors show inline or as toasts? -> A: Inline within the affected component [FR-010, US-4]

Parsing

Parsers should extract references with:

/\[((?:(?:FR|US|SC)-\w+(?:,\s*)?)+)\]\s*$/

This captures the trailing [...] bracket and splits on , to get individual IDs.

Install with Tessl CLI

npx tessl i tessl-labs/intent-integrity-kit

skills

README.md

tile.json