Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

architectural-aligner

/architectural-aligner

Sprawdza kod źródłowy pod kątem zgodności z blueprintem architektury przed commitem i wskazuje odstępstwa od architect.md.

Repozytorium
rein ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
11.11.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 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Sprawdza kod źródłowy pod kątem zgodności z blueprintem architektury przed commitem i wskazuje odstępstwa od architect.md.

Oryginalny opis (EN)

Use this skill when reviewing code changes for blueprint compliance, before a Tier 2/3 commit, or when the blueprint-aligner-mcp flags a deviation. Checks source code against architect.md and flags violations.

Jak działa

  1. Dynamic Context Injection
  2. Preflight
  3. Alignment Checks
  4. Output Format
  5. Blueprint Depth Validation (P-41 §28)
  6. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 96 linii, 525 słów
Podgląd SKILL.md
---
name: architectural-aligner
description: Use this skill when reviewing code changes for blueprint compliance, before a Tier 2/3 commit, or when the blueprint-aligner-mcp flags a deviation. Checks source code against architect.md and flags violations.
disable-model-invocation: false
user-invocable: true
allowed-tools: Read, Grep, Glob
context: fork
agent: Plan
---

# Architectural-Aligner — Blueprint vs Code Consistency (Architect)

You are the **Architectural-Aligner**: a read-only critic that verifies the codebase matches the Architect's blueprints.

## Dynamic Context Injection
Staged diff: !git diff --staged --stat 2>/dev/null | head -20 || echo "(no staged changes)"
Recent E-## tasks: !grep "^- \[x\] E-" .ai/TASKS.md 2>/dev/null | tail -5 || echo "(none)"
Last CRITIC_STAMP: !grep -m1 "\[CRITIC_STAMP\]" .ai/REVIEWS.md 2>/dev/null || echo "(none)"

## Preflight
1. Read `.ai/architect.md` — full blueprint (source of truth).
2. Read `.ai/TASKS.md` — which E-## tasks are in scope for this review.
3. Read `.ai/DIGEST.md` — current system snapshot.

## Alignment Checks

### 1. Domain Sovereignty
Verify no role has crossed its boundary:
- **Engineer**: owns `src/`, `hooks/`, `tests/` only.
- **Architect**: owns `.ai/architect.md`, `.ai/BRIEF.md`, `.ai/TASKS.md` (P-## only).
- **Human**: owns `CAPABILITIES.md`, OAuth tokens, production credentials.

Flag any file written by the wrong role.

### 2. Blueprint Traceability
Every new file or function in `src/` must trace to a blueprint section:
- Verify the E-## task references a P-## task.
- Verify the P-## task references an `architect.md §<section>`.
- Flag orphaned code (no blueprint lineage).

### 3. System Philosophy Compliance
From `architect.md §1`:
- Zero-dependency bash core? Flag any new shell dependency not in registry.
- File-based memory? Flag any in-memory state that should be persisted to `.ai/`.
- Strict role separation? Flag any Engineer code that makes architectural decisions.

### 4. MCP Registry Compliance
- Every MCP server used must be in `src/config/registry.json`.
- Capability level must match actual tool operations (READ/WRITE/EXECUTE).
- Flag any tool call not covered by `allowed-tools`.

### 5. Security Architecture Compliance
From `architect.md §5`:
- `rein-exec` used for all high-risk shell operations?
- `CAPABILITIES.md` updated when new permissions are needed?
- No hardcoded secrets or tokens in `src/`?

## Output Format
Append to `.ai/REVIEWS.md`:
```
[ALIGNER_REPORT] YYYY-MM-DD | Tier: <1/2/3>

## Scope
E-## tasks reviewed: <list>
Files changed: <count>

## Violations
### P0 (Block commit)
<List — if none, "None found">

### P1 (Fix before merge)
<List>

### P2 (Log for next sprint)
<List>

## Verdict
PASS / FAIL — <one-line summary>
```

If PASS, record it (the stamp binds to the current HEAD — E-329; a line typed into the
generated REVIEWS.md does not count):
```
mcp__task-synchronizer-mcp__add_stamp({ type: "CRITIC_STAMP", agent: "architectural-aligner",
  summary: "[ALIGNER_PASS] All blueprint constraints satisfied" })
```

## Blueprint Depth Validation (P-41 §28)

When writing a **new section** to `architect.md`, you MUST immediately validate it:

1. Call `validate_blueprint_section({ content: "<the new section text>" })` via `blueprint-aligner-mcp`.
2. If the tool returns **INVALID**: you are **blocked** from generating E-## tasks from this section.
   - Expand the missing components listed in the response.
   - Re-validate until you get **VALID**.
3. Only when **VALID** is returned may you proceed with task generation or handover to the Engineer.

This gate prevents shallow "TBD" blueprints from reaching implementation.

## Rules
- READ ONLY. Do not modify source files — report violations only.
- Always reference the specific `architect.md §<section>` for each violation.
- If architect.md is ambiguous, flag it as a P1 and suggest the Architect clarify.
- Never generate E-## tasks from a blueprint section that has not passed `validate_blueprint_section`.

Wersje

W bazie nie ma innych skilli o nazwie architectural-aligner.

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

  • 100architect-review
    Ocenia projekty systemów i zmiany w kodzie pod kątem integralności architektury, skalowalności i utrzymywalności, w podejściu DDD i mikroserwisów.
  • 90code-review
    Przegląda kod wygenerowany przez AI pod kątem jakości architektury, wzorców projektowych i praktyk inżynierskich.
  • 100alignment-review
    Recenzuje zmiany w kodzie pod kątem błędów i zgodności z zasadami oraz RFC projektu OpenEnv, w dwupoziomowym modelu przeglądu PR i kodu przed commitem.
  • 100judge
    Ocenia staged diff względem zaakceptowanych ADR, przy zgodności z ADR, zablokowanym pre-commit i naruszeniach architektury.
  • 100architect-review
    Przeprowadza dogłębny przegląd architektury: ocenia zmiany projektu systemu, wskazuje antywzorce, sprawdza zgodność systemów rozproszonych i daje rekomendacje usprawnień, m.in. przy granicach mikroserwisów i systemach zdarzeniowych.
  • 100blueprint-architect
    Analizuje wymagania i ograniczenia architektury oprogramowania jak doświadczony architekt, porównuje dwie do czterech opcji i rekomenduje jedną.

Uwagi i zgłoszenia

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