Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
305 changes: 305 additions & 0 deletions .impeccable/design.json

Large diffs are not rendered by default.

903 changes: 903 additions & 0 deletions .plans/kiloclaw-org-billing.md

Large diffs are not rendered by default.

1,355 changes: 348 additions & 1,007 deletions .specs/kiloclaw-billing.md

Large diffs are not rendered by default.

338 changes: 73 additions & 265 deletions .specs/kiloclaw-datamodel.md

Large diffs are not rendered by default.

857 changes: 328 additions & 529 deletions .specs/team-enterprise-seat-billing.md

Large diffs are not rendered by default.

37 changes: 14 additions & 23 deletions .specs/template.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,54 +2,45 @@

## Role of This Document

This spec defines the business rules and invariants for [feature].
It is the source of truth for _what_ the system must guarantee —
valid states, ownership boundaries, correctness properties, and
user-facing behavior. It deliberately does not prescribe _how_ to
implement those guarantees: handler names, column layouts,
conflict-resolution strategies, and other implementation choices
belong in plan documents and code, not here.
This spec defines [feature] business rules and invariants: valid states, ownership boundaries, correctness properties,
and user-facing behavior. It is the source of truth for _what_ the system must guarantee, not _how_ to implement it.
Handler names, column layouts, conflict-resolution strategies, and other implementation choices belong in plans and code.

## Status

Draft -- created YYYY-MM-DD.

## Conventions

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in
BCP 14 [RFC 2119] [RFC 8174] when, and only when, they appear in all
capitals, as shown here.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT
RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC 2119] [RFC 8174]
when, and only when, they appear in all capitals, as shown here.

## Definitions

- **Term**: Definition of a domain-specific term used throughout
this spec.
- **Term**: Domain-specific term definition used throughout this spec.

## Overview

A concise narrative (1-2 paragraphs) describing the feature from a
user and system perspective. Cover what the feature does, who it
serves, and the high-level lifecycle. Avoid implementation details.
Concise narrative (1-2 paragraphs) describing the feature from user and system perspectives. Cover what the feature
does, audience, and high-level lifecycle. Avoid implementation details.

## Rules

### [Section Name]

1. The system MUST ...
2. The system MUST NOT ...
1. System MUST ...
2. System MUST NOT ...

## Error Handling

1. When [error condition], the system MUST [behavior].
1. When [error condition], system MUST [behavior].

## Not Yet Implemented

The following rules use SHOULD and reflect intended behavior that is
not yet enforced in the current codebase:
Intended SHOULD rules not yet enforced in the current codebase:

1. The system SHOULD ... (Currently ...)
1. System SHOULD ... (Currently ...)

## Changelog

Expand Down
Loading