Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

site-map-readiness

/site-map-readiness

Ocenia, czy projekt nadaje się do odwzorowania w mapie aplikacji, na podstawie rodzaju aplikacji, frameworków i tego, czy ekstraktor obejmuje jej kształt.

Repozytorium
paqad-ai ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.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

Ocenia, czy projekt nadaje się do odwzorowania w mapie aplikacji, na podstawie rodzaju aplikacji, frameworków i tego, czy ekstraktor obejmuje jej kształt.

Oryginalny opis (EN)

Grades whether the project is mappable (app kind, frameworks, an extractor that covers its shape) and routes the unmappable case. Use when a site-map run starts; it always runs first.

Jak działa

  1. What It Does
  2. Use This When
  3. Inputs
  4. Procedure
  5. Output Contract
  6. Escalate / Stop Conditions
  7. Resources
Sekcje z nagłówków SKILL.md, w oryginale · 49 linii, 291 słów
Podgląd SKILL.md
---
name: site-map-readiness
description: 'Grades whether the project is mappable (app kind, frameworks, an extractor that covers its shape) and routes the unmappable case. Use when a site-map run starts; it always runs first.'
metadata:
  model_tier: fast
  cacheable: 'false'
  output_format: json
  paqad-meta: skill.meta.yaml
---

## What It Does

Confirms the project is mappable before the workflow spends any effort: the app kind and
frameworks are detectable, and at least one extractor covers the app's shape. Emits a
readiness verdict (`ready | partial | blocked`) that gates everything downstream. Runs first,
like `design-system-coverage` gates the design-test workflow.

## Use This When

As the **first skill in every site-map run**. Never run extraction, modeling, or
verification without a `ready` or `partial` verdict from it.

## Inputs

- Read `.paqad/project-profile.yaml` for the detected `active_capabilities` and `stack_profile`.
- Read the project manifests the profile points at (`package.json`, `composer.json`, lockfiles).
- Read `references/readiness-criteria.md` before grading.

## Procedure

The verdict is a deterministic function of what the engine can detect: drive it from the
engine, do not re-derive detection in prose.

1. Run `paqad-ai sitemap run` and read the `readiness` and `blocked_checks` it reports; the
   engine owns app-kind and framework detection.
2. Grade the verdict: `ready` when an extractor covers the app shape, `partial` when only the
   generic convention fallback applies, `blocked` when no extractor covers the shape.
3. Emit the readiness inventory (app kind, frameworks, extractor, verdict, blocked reasons).

## Output Contract

- A JSON object `{ app_kind, frameworks: [...], extractor, verdict, blocked_checks: [...] }`.
- `verdict` ∈ `ready | partial | blocked`.
- A `blocked` verdict must carry at least one `blocked_checks` entry with a reason.

## Escalate / Stop Conditions

- Stop when the verdict is `blocked`: surface the engine's `blocked_checks` reason and do not
  fabricate surfaces to fill the gap.
- Warn when the verdict is `partial`: downstream skills run in exploratory mode and tag
  surfaces `confidence: low`.
- Do not upgrade a `partial` verdict to `ready` to unblock the run.

## Resources

- `references/readiness-criteria.md`
- `agents/openai.yaml`
Pliki w paczce (4)
  • SKILL.md 2 KB
  • skill.meta.yaml 1 KB
  • agents/openai.yaml 1 KB
  • references/readiness-criteria.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie site-map-readiness.

Migawka bazy z 13.11.2026 · wersja paczki 503938722dcb (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

  • 100site-map
    Buduje i sprawdza mapę aplikacji: ekrany, przejścia, strażników i ścieżki użytkownika, a potem porównuje zapisaną mapę z kodem.
  • 90site-map-retest
    Sprawdza ponownie zapisaną mapę aplikacji względem kodu, powtarzając tę samą weryfikację i nie łagodząc ani nie wymyślając ustaleń.
  • 90production-readiness-scorecard-map-roadmap
    Wykonuje workflow mapy drogowej karty gotowości produkcyjnej dla projektów w Go: audyt, weryfikację i realizację zadań.

Uwagi i zgłoszenia

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