Skip to main content
Compendium · Compositions · Score Rubrics

Score Rubrics

Items
16
of 1002 total

Full-featured composed scenes — one per row so each design has room to breathe. Click for the live render, the spec, and the source.

№ 1301

ICS Explainer

Scene STA do
DO · Rubric ICS · v2

Intent Completion Score
four dimensions. one number.

Aggregate

79/100

DEVELOPING
C Completeness
w · 30

All five canonical sections present and non-empty.

Sample sub-score 26/30
T Testability
w · 25

Each acceptance criterion is independently verifiable.

Sample sub-score 21/25
U Unambiguity
w · 25

No "should", "where appropriate", or pronoun ambiguity.

Sample sub-score 18/25
X Threat coverage
w · 20

STRIDE classes named, abuse cases enumerated.

Sample sub-score 14/20

// Formula

ICS = 1.0·C(30) + 1.0·T(25) + 1.0·U(25) + 1.0·X(20)
band(ICS): READY ≥ 85 · DEVELOPING ≥ 60 · UNFIT < 60
spec · SPEC-014 · v1.3.0 author · @author reviewer · @governor
Compositions / score rubrics

Intent Completion Score broken into four dimensions with sample scores, the weighted formula, and READY/DEVELOPING/UNFIT band thresholds.

open ↗
№ 1302

CCS Explainer

Scene STA go
GO · Rubric CCS · convention clarity

A convention is
a testable rule, not a slogan.

CCS

80/100

REVISE
Worked example "ALL files MUST use kebab-case"
scored against 4 dims ↓
P Precision
5/5
Words used have one defined meaning.
D Detectability
4/5
Violations are surfaceable by a linter, not a code review.
K Completeness
3/5
All cases covered — edge cases named, not punted.
S Scope clarity
4/5
Says exactly which files / domains it applies to.
if PASSadopt — wire to linter
if REVISEreturn to @author w/ notes
if DROPunconventionable · scrap
Compositions / score rubrics

Convention Clarity Score — precision, detectability, completeness, scope clarity — rendered as four scored panels with a worked example.

open ↗
№ 1303

SDS Explainer

Scene STA go
GO · Rubric SDS · STRIDE coverage

A threat without a mitigation
is a debt with a payment date.

SDS coverage

70%

PARTIAL
Asset STRIDE
auth-service
spec-store
agent-runtime
audit-log
webhook-bus
column % 809050806060
covered · mitigation named partial missing
Compositions / score rubrics

Security Design Score — a STRIDE coverage grid showing which threat classes have mitigations specified per asset.

open ↗
№ 1304

CSG Explainer

Scene STA go
GO · Guard CSG · constraint symmetry

Two specs. One impossible truth.

auth-session SPEC-019 · v2.1.0
## Constraints
- Token TTL: 8h hard ceiling
- Refresh window: 1h before expiry
- Issued by: auth-service only
owner · @author
symmetric
contradiction
mobile-resume SPEC-022 · v1.4.0
## Constraints
- Offline session: 24h minimum
- Cached spec data: 7d
- Refresh on network return
owner · @author

Merge blocked

8h ≤ TTL ≤ 8h cannot coexist with 24h ≤ TTL — both surfaces resolve to the same token.

CSG · BLOCK

// Suggested resolution

Split the surface: introduce a separate offline-grant token, keep session at 8h. Then re-run CSG.

Compositions / score rubrics

Constraint Symmetry Guard — diffs two specs side-by-side, surfaces a head-on contradiction, and refuses the merge.

open ↗
№ 1305

SHS Explainer

Scene STA do
SHS · Corpus health org · acme · 71 specs
refresh · 14:02:14 UTC

// Distribution

74/100

3
0–19
7
20–39
14
40–59
28
60–84
19
85–100

// Stale > 120 days

  • SPEC-007 184d UNFIT
  • SPEC-019 156d DEVELOPING
  • SPEC-031 142d DEVELOPING
  • SPEC-044 121d READY
DO
78 ▲ 2
mean ICS · 30d delta
CO
71 ▼ 3
mean ICS · 30d delta
DE
66 ▲ 1
mean ICS · 30d delta
GO
82 ▲ 4
mean ICS · 30d delta
Compositions / score rubrics

Spec Health Score corpus dashboard — distribution histogram, stale-spec list, and per-pillar mean health across an org.

open ↗
№ 1306

SCR Explainer

Scene STA go
GO · Radar SCR · supply chain

Dependencies have a pulse.
measure it before you trust it.

SCR aggregate

61

WATCH

// CVE coverage

scanned 84%

last scan · 41 min ago

// Vitality · release / maint / commit

  • astro 92·88·95
  • tailwindcss 89·76·84
  • react 81·90·78
  • left-pad-fork 12·8·14
  • crypto-shim 44·28·31
Compositions / score rubrics

Supply Chain Radar — CVE-coverage gauge plus per-dependency vitality bars and trust band.

open ↗
№ 1307

Two-stage Quality Gate

Scene STA go
GO · Pipeline two-stage gate

Structure first. Score second.

A high score on a malformed spec is a more confident wrong answer. Structure is the prerequisite, not a dimension.

Stage 1 · Structural binary
  • frontmatter present & well-formed
  • five canonical sections non-empty
  • no dangling spec refs
  • no TODO / TBD tokens
FAIL · reject
Stage 2 · Rubric numeric
  • ICS 86/100
  • CCS 79/100
  • SDS 71/100
READY · band
Compositions / score rubrics

A flow diagram of the two-stage gate — structural pass/fail first, rubric scoring second. Specs cannot skip the structural gate to chase a high score.

open ↗
№ 1308

Zero-Dimension Veto

Scene STA go
GO · Rule zero-dimension veto

High aggregate. Empty dimension.
Veto wins.

aggregate

74/100

VETO
C Completeness 28/30
T Testability 22/25
U Unambiguity 24/25
X Threat cov. 0/20
ZERO
0

Dimension `Threat cov.` scored zero.

Whole-rubric VETO triggers regardless of aggregate. A spec cannot ship without ANY threat coverage — security is not optional to make up later.

policy · GOV-002
whyaggregates hide gaps
scopeevery rubric · every dim
overridegovernor + risk note
Compositions / score rubrics

Any dimension scoring 0 fails the whole rubric — a high aggregate cannot rescue an empty dimension. A worked example shows a 84/100 spec rejected.

open ↗
№ 1309

Threat Floor

Scene STA go
GO · Rule threat coverage floor

Below the floor, nothing ships.

Per-dimension minimums force authors to address security at design time, not after launch.

blocked

2/5

FLOOR · 12

// Threat coverage · five specs

  • SPEC-014
    18
  • SPEC-019
    14
  • SPEC-021
    12
  • SPEC-024
    8
  • SPEC-029
    4
floor at x = 12 / 20

Above floor. Continue rubric scoring. The floor is necessary, not sufficient.

Below floor. Hard block — no waivers, no aggregate rescue. Return to threat modelling.

Compositions / score rubrics

A floor-line chart that shows the minimum threshold a threat-coverage dimension must clear — specs below the line cannot ship even with high overall scores.

open ↗
№ 1310

Rubric Anti-pattern

Scene STA go
!! DO NOT rubric misuse · v1

Thresholds do not replace judgment.

  1. 01

    Score-shopping

    DON'TSpecs rewritten purely to inch the number above the band threshold without changing intent.

    DOScore is a signal — not the artefact. Edit intent, not adjectives.

  2. 02

    Threshold as escape hatch

    DON'TA spec at exactly 60.0 is "DEVELOPING but shippable" — the band edge becomes the new normal.

    DOBands are bins, not pass-marks. Edge cases trigger human review, not silent merge.

  3. 03

    Human off the loop

    DON'TAuto-merge any READY-band spec. No governor read-through, no risk note, no record.

    DOScore gates filter — they do not approve. A human is on every irreversible step.

A score is a question, not an answer.

policy · GOV-007
Compositions / score rubrics

Do not use thresholds to replace judgment — a stamped warning panel with three concrete misuses of rubric scores.

open ↗
№ 1311

Configurable Thresholds

Scene STA go
GO · Config per-team thresholds

Same rubric. Different bindings.

Regulated work cannot calibrate the same way as prototype work. The numbers are the same. The thresholds are not.

pay-rails

regulated · external

team / 02
  • ICS READY ≥ 92 · DEV ≥ 75
  • CCS READY ≥ 88 · DEV ≥ 70
  • SDS READY ≥ 95 · DEV ≥ 80
approved · @governor · 2026-05-12

lab-sandbox

prototype · internal

team / 02
  • ICS READY ≥ 70 · DEV ≥ 50
  • CCS READY ≥ 65 · DEV ≥ 45
  • SDS READY ≥ 60 · DEV ≥ 35
approved · @governor · 2026-05-12

// Delta · pay-rails − lab-sandbox

  • ICS +22 READY · +25 DEV
  • CCS +23 READY · +25 DEV
  • SDS +35 READY · +45 DEV
Compositions / score rubrics

A per-team threshold-calibration panel — same rubric, different bands per risk profile. A regulated team and a prototype team configured side-by-side.

open ↗
№ 1312

Baseline Calibration

Scene STA go
GO · Onboarding baseline calibration

Three steps before a single threshold fires.

  1. 01 Sample

    Pick 20 random specs from the last 6 months.

    outcome

    representative cross-section, not cherry-picked exemplars

  2. 02 Score

    Score them all by hand. Two reviewers per spec, blind to each other.

    outcome

    inter-rater drift becomes visible, dimensions tightened

  3. 03 Recalibrate

    Set the team's READY threshold at the 75th percentile of observed scores.

    outcome

    stretches but does not break — top-quartile becomes the floor

// Before · uncalibrated

75th pct ≈ 71 · noisy

// After · calibrated

75th pct ≈ 82 · sharpened

Compositions / score rubrics

A three-step walkthrough — sample, score, recalibrate — showing before-and-after distributions when a team first adopts a rubric.

open ↗
№ 1313

Risk-Stratified Review

Scene STA go
GO · Matrix risk × score = depth

Same score. Bigger blast. Deeper review.

Risk \ Score UNFITDEVELOPINGREADY
HIGH HARD BLOCKGOV + AUTHORDUAL SIGN-OFF
MED HARD BLOCKGOVERNOR READPEER REVIEW
LOW REWRITEPEER REVIEWAUTO-MERGE
auto-merge
peer review
governor read
dual sign-off
hard block
Compositions / score rubrics

A 3x3 matrix mapping spec risk × score band to review depth — same score earns different scrutiny depending on the blast radius.

open ↗
№ 1314

Sampling Strategies

Scene STA do
DO · Practice sampling strategies

You will not score them all.
Pick a sampling strategy on purpose.

Systematic every 4th

// pick pattern · n=24

when:continuous health monitoring

coverage 25%
Random stratified

// pick pattern · n=24

when:unbiased corpus snapshots

coverage 25%
Spot-check governor-flagged

// pick pattern · n=24

when:incident response · drift

coverage 13%

Combine, don't pick one.Most teams run systematic on a 30-day cadence, random on quarterly snapshots, spot-check on every incident.

guidance · DO-014
Compositions / score rubrics

Three sampling strategies — systematic, random, spot-check — as side-by-side cards with use-case, cadence, and visualised pick pattern.

open ↗
№ 1315

Score Trends

Scene STA do
DO · Trends 12 weeks · 6 rubrics

A score is a point.
A trend is the story.

period · 2026-03-01 → 2026-05-21
AAR ▲ 6
After-action recall 82
GTR ▼ 4
Green-to-red 74
SDL ▲ 5
Spec design lint 77
DDL ▲ 5
Drift detection 85
ICS ▲ 5
Intent completion 83
CCS ▲ 3
Convention clarity 70
readdirection · not just level
flag3-period sustained ▼
window12 weeks rolling
Compositions / score rubrics

Six sparklines side-by-side — AAR, GTR, SDL, DDL, ICS, CCS — showing 12-week trends with deltas and direction badges.

open ↗
№ 1316

Score-to-Action Map

Scene STA go
GO · Pipeline score → action

A number that triggers nothing
is just decoration.

Band · range Action Owner SLA d
Approved 85 – 100
A auto-merge to mainline
@gatekeeper 0
Ready 70 – 84
H governor sign-off + ship
@governor 1
Developing 40 – 69
H return to author with notes
@author 3
Unfit < 40
H rewrite from intent — do not patch
@author + @governor 7
A

Automated band. Only Approved is allowed to auto-merge. Everywhere else, a human owns the next move.

H

Human band. SLA starts when the band is entered. Missed SLAs escalate to the governor — not the author.

Compositions / score rubrics

A vertical band map — each score band emits a specific action, owner and SLA. Scores are not vibes; they are pipelines.

open ↗
Alpha · Honest about it

The framework is real.
The community is forming now.

DoCoDeGo is in Alpha. The framework is documented, the practices are battle-tested at small scale, and the next release is being shaped in public.

If it produces anything, it should produce engineers and teams who think more clearly about what they are building and why.

Two doors in
Join the Discord

Discord is where specs are debated, the framework gets sharper, and decisions land in writing. The conversation is the artefact.