Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Analiza

contract-status

/contract-status

Pokazuje w CLI status kontraktu lub wszystkich kontraktów w toku: fazę, pozostały czas SLA (IST i UTC), gotowość i następne działanie.

Repozytorium
manifest ↗
Licencja
MIT
Ostatnia zmiana repozytorium
02.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 02.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Pokazuje w CLI status kontraktu lub wszystkich kontraktów w toku: fazę, pozostały czas SLA (IST i UTC), gotowość i następne działanie.

Wyzwalacze z opisu

statuswhere are wewhattime left
Oryginalny opis (EN)

Show the current status of a contract (or all in-flight contracts) right in the CLI — phase, SLA time-left (IST + UTC), readiness, and the next action. Use when the user says "status", "where are we", "what's in flight", "time left", or invokes `/status [<ID>]`.

Jak działa

  1. Usage
  2. One contract
  3. All in-flight (the dashboard)
  4. Epic rollup — /status <epic-ID> (multi-person feature view)
  5. Notes
  6. Anti-patterns
Sekcje z nagłówków SKILL.md, w oryginale · 123 linii, 703 słów
Podgląd SKILL.md
---
name: contract-status
description: Show the current status of a contract (or all in-flight contracts) right in the CLI — phase, SLA time-left (IST + UTC), readiness, and the next action. Use when the user says "status", "where are we", "what's in flight", "time left", or invokes `/status [<ID>]`.
---

# Contract status

A quick "where does this stand" view, computed deterministically — no
LLM guessing about phase or time. Powered by `validate.mjs --status`.

## Usage

- `/status <ID>` — one contract
- `/status` — every contract currently in flight (status `promoted`
  and not yet `landed`), most-urgent first

## One contract

Run:

```bash
node <plugin-root>/scripts/validate.mjs --status .manifest/contracts/<ID>.md
```

It prints (deterministically from the contract frontmatter):

```
AUTH-12 — Resend OTP on login
  phase:     ② In review
  ⏳ SLA: 23h 14m left (due 2026-05-21 13:30 IST / 2026-05-21 08:00 UTC)
  readiness: review_needed  ·  promotable: ✅ (0 blockers, 2 advisory warnings)
  next:      promote, or address warnings first
```

Relay it as-is. If `--status` exits non-zero, the SLA is overdue —
call that out. **Lead with `promotable` (0 open blockers) — that's the
real gate.** When `promotable` is true, say so even if readiness is
`review_needed`; open warnings are advisory and never block, so a dev
isn't stuck. (Read open blocker/warning counts from the latest
`<ID>.findings.json` if present.)

**Who holds the ball (PM accountability).** If the contract has a
`pickup.ballLog`, compute the ledger — `node scripts/ready-check.mjs
--ledger <ballLog.json> <slaHrs> <promotedAt>` — and lead with it when the
ball is with the PM. The SLA is charged **only for dev-side time**, so report
the *effective* SLA (paused while blocked on PM), not raw elapsed:

```
🟡 blocked on PM 2d 4h (SLA paused) · dev used 6h/48h · 2 bounces
   → nudge the PM, or proceed on the dev's assumption
```

This is the anti-blame line: a dev is never shown as overdue for time the PRD
gap left the ball with the PM.

## All in-flight (the dashboard)

1. List `.manifest/contracts/*.md` (exclude `.findings.md`, `.r*.md`,
   `.deploy-*`, `.launch-report-*`, `.bug-log.md`, `.decomposition.md`,
   and `.fixes/`).
2. For each whose `status` is `promoted` and `landed` is unset, run
   `--status`.
3. Sort by SLA urgency: overdue first, then least time left.
4. Print a compact table:

```
IN FLIGHT (3)

⚠️  AUTH-12  ② In review        SLA OVERDUE by 1h 20m        → review + merge
⏳⚠️ SC-007   ③ Canary rollout    3h 10m left                  → approve next stage
⏳  PAY-3    ② Building          18h left                     → @claude /implement PAY-3

Epics: AUTH-30 (3/4 children shipped)
```

5. If nothing is in flight, say so and suggest `/contract new` or
   `/fix`.

## Epic rollup — `/status <epic-ID>` (multi-person feature view)

When the ID is an **epic** (`type: epic` with `children: [...]`), show the whole
feature in one glance instead of per-contract. This is the coordination view for a
feature worked by several people across repos.

1. Read the child contracts listed in `children`. For each, collect
   `{ id, owner, repo, size, status, landed, dependsOn }`.
2. Compute the rollup deterministically:
   `node scripts/ready-check.mjs --rollup <children.json>`. It returns per-child
   **state** (`landed` / `blocked` / `ready` / in-flight status), each blocked
   child's `blockedBy`, the **critical path**, `done/total`, and `landed` (true
   only when **every** child has landed).
3. Render — lead with the finish line and the critical path, group by owner:

```
EPIC  SC-100 · Saved cards at checkout        2/4 shipped · not landed
critical path:  SC-a → SC-b → SC-d
success metric: +6% checkout conversion (measured once the feature lands)

  @be-dev    SC-a  backend  ✅ landed
  @fe-dev-1  SC-b  web      ② building
             SC-d  web      ⛔ blocked — waiting on SC-b, SC-c
  @fe-dev-2  SC-c  web      ▶ ready to start (deps met)

next: SC-c is unblocked — @fe-dev-2 can start. SC-d is the critical-path tail.
```

4. **Feature accountability** — a feature isn't "done" because one dev finished;
   it lands only when **all** children land and the metric moves. Lead with any
   cross-child block (who's waiting on whom) so nobody stalls silently, and pair it
   with the PM ledger (blocked-on-PM) where relevant.

## Notes

- Times always show BOTH IST and UTC (the validator's formatter does
  this; don't reformat).
- This is read-only — it never changes a contract. Safe to run anytime.
- For an epic, show child progress (how many children have `landed`).
- Phase and next-action come from `derivePhase` in the validator, so
  they're consistent with what every other update shows.

## Anti-patterns

- Don't recompute phase or time-left by hand — use `--status` so it
  matches every other surface.
- Don't list landed/closed contracts in the in-flight view (only
  promoted-and-not-landed).

Wersje

W bazie nie ma innych skilli o nazwie contract-status.

Migawka bazy z 13.11.2026 · wersja paczki c5b299e5d458 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100session-status
    Pokazuje, co zostało w sesji: pracę w toku, nieodpowiedziane pytania, nierozstrzygnięte decyzje, blokery i proponowany tytuł.
  • 100fleet-status
    Pokazuje na jednym ekranie, tylko do odczytu, stan działającego lub właśnie zakończonego /fleet-launch: czas do terminu, księgi sesji, worktree w toku, dostarczone prace i pozostały zakres.
  • 90project-status
    Przeprowadza rundę statusu bieżącego projektu: co jest w toku, co można zamknąć i co dalej, dla kodu i projektów graficznych.
  • 90pc-status
    Pokazuje postęp wszystkich planów w repozytorium lub jednego z nich i podaje, co uruchomić dalej.
  • 95status
    Pokazuje w skrócie bieżącą fazę cyklu, stan dyspozytora, liczbę zadań i ostatnie decyzje w przepływie.
  • 100task-status
    Pokazuje szybki, tylko do odczytu stan jednego lub wielu śledzonych zadań z bloku cyklu życia kontraktu: faza, zmienione ścieżki, dowody, blokery, decyzje i następne polecenie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.