Skip to content
Closed
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
38 changes: 37 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@ Restart your AI coding assistant (or open a new session) in any LFX repo and typ
/lfx-backend-builder
/lfx-ui-builder
/lfx-product-architect
/lfx-review-guard
/lfx-preflight
/lfx-pr-catchup
/lfx-setup
Expand Down Expand Up @@ -114,7 +115,9 @@ The skills form a layered system where each skill has a clear responsibility and
│ builder │ builder │ (read-only │ exploration) │
│ (codegen)│ (codegen)│ guidance) │ │
├──────────┴──────────┴───────────────┴───────────────────┤
│ /lfx-preflight (validation) │ /lfx-setup (env) │
│ /lfx-review-guard (self-review) │ /lfx-preflight (valid) │
├──────────────────────────────────┴────────────────────────┤
│ /lfx-setup (env) │
├───────────────────────────────┴─────────────────────────┤
Comment on lines +118 to 121
Copy link

Copilot AI Mar 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The ASCII architecture diagram looks misaligned: the /lfx-setup (env) row is a single full-width cell, but the separator below it uses a split junction () as if there were two columns. Also, /lfx-preflight (valid) is an unclear abbreviation compared to “validation” used elsewhere. Consider adjusting the box-drawing characters and label so the diagram renders consistently in a monospace block.

Suggested change
│ /lfx-review-guard (self-review) │ /lfx-preflight (valid) │
├──────────────────────────────────┴────────────────────────┤
│ /lfx-setup (env) │
├────────────────────────────────────────────────────────┤
│ /lfx-review-guard (self-review) │ /lfx-preflight (validation) │
├──────────────────────────────────┴────────────────────────┤
│ /lfx-setup (env) │
├────────────────────────────────────────────────────────┤

Copilot uses AI. Check for mistakes.
│ /lfx-pr-catchup (standalone — morning PR dashboard) │
└─────────────────────────────────────────────────────────┘
Expand All @@ -130,6 +133,7 @@ The skills form a layered system where each skill has a clear responsibility and
| `/lfx-backend-builder` | Generates Express.js proxy endpoints, Go microservice code, shared types. Encodes three-file pattern, logging, Goa DSL, NATS messaging | Code gen | Bash, Read, **Write, Edit**, Glob, Grep, AskUserQuestion |
| `/lfx-ui-builder` | Generates Angular 20 components, services, drawers, pagination UI, styling. Encodes signal patterns, PrimeNG wrappers | Code gen | Bash, Read, **Write, Edit**, Glob, Grep, AskUserQuestion |
| `/lfx-product-architect` | Answers "where should this go?", traces data flows, makes placement decisions, explains design patterns | Read-only | Bash, Read, Glob, Grep, AskUserQuestion |
| `/lfx-review-guard` | Self-review checklist — catches 15 common reviewer blockers before or after submitting a PR | Read-only | Bash, Read, Glob, Grep, AskUserQuestion |
| `/lfx-preflight` | Pre-PR validation — auto-fixes formatting & license headers, runs lint, build, checks protected files, offers PR creation | Validate + fix | Bash, Read, **Write, Edit**, Glob, Grep, AskUserQuestion |
| `/lfx-pr-catchup` | Morning PR dashboard — unresolved comments, status changes, stale PRs, approved-but-not-merged across all your open PRs | Read-only | Bash, Read, Glob, Grep, AskUserQuestion |
| `/lfx-setup` | Environment setup — prerequisites, clone, install, env vars, dev server. Adapts to Angular or Go repos | Interactive guide | Bash, Read, Glob, Grep, AskUserQuestion |
Expand Down Expand Up @@ -279,6 +283,31 @@ A **read-only** advisory skill that answers architectural questions without gene

---

### `/lfx-review-guard`

A **read-only** self-review checklist that catches the patterns most commonly flagged by reviewers. Can be run after development (before `/lfx-preflight`) or on PRs already submitted.

**15 checks:**
1. **Raw HTML elements** — raw `<input>`, `<select>`, `<textarea>` must use LFX wrappers; `animate-pulse` divs must use `<p-skeleton>`
2. **Dead code** — unused providers, imports, methods, signals, unbound component outputs
3. **Component responsibility** — 4+ service injections flagged for discussion (god components)
4. **Loading states** — stats showing `0` during loading, missing guards, loading not reset on re-fetch
5. **Type safety in templates** — no `!` non-null assertions, no falsy `||` where `??` is needed
6. **Error handling** — no silent or duplicate/unreachable `catchError`; consistent fallbacks
7. **Signal patterns** — no `BehaviorSubject` for simple state, no `cdr.detectChanges()`, no `model()` for internal state
8. **Upstream API alignment** — parameter names match upstream contracts, no invented fields
9. **PR description completeness** — removed UI elements, permission changes, and error handling changes documented
10. **Accessibility** — `aria-pressed` on toggles, no nested interactive elements, no focusable items behind overlays
11. **Design token compliance** — no hardcoded Tailwind colors; use LFX design tokens
12. **N+1 API patterns** — no per-item API calls in loops when batch endpoints exist
13. **Template/config completeness** — every config entry has a matching template case, no partial wiring
14. **Stale data during navigation** — components re-fetch on input/route changes, no stuck loading states
15. **Visitor/permission gating** — permission guards account for role loading state, no content flashing

**Output:** Each check reports `✓` pass, `⚠` discuss, or `✗` blocker with file locations and fix suggestions.

---

### `/lfx-preflight`

Runs a comprehensive **pre-PR validation** with auto-fix capabilities. Adapts all checks to the repo type.
Expand Down Expand Up @@ -416,6 +445,11 @@ An **interactive setup guide** that walks through environment configuration step
/lfx-test-journey teardown <name> → cleans up when done
```

### Self-review for reviewer blockers
```
/lfx-review-guard → scans changed files → reports blockers, discussion items, and passes → fix or proceed
Copy link

Copilot AI Mar 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This workflow line suggests /lfx-review-guard can “fix or proceed”, but the skill is documented as read-only/report-only (no Write/Edit). Please reword to indicate the user (or another skill) fixes blockers before proceeding.

Suggested change
/lfx-review-guard → scans changed files → reports blockers, discussion items, and passes → fix or proceed
/lfx-review-guard → scans changed files → reports blockers, discussion items, and passes → you or another skill fix any blockers before proceeding

Copilot uses AI. Check for mistakes.
```

### Validate before submitting a PR
```
/lfx-preflight → license headers → format → lint → build → protected files → PR
Expand Down Expand Up @@ -460,6 +494,8 @@ An **interactive setup guide** that walks through environment configuration step
│ └── frontend-service.md # Service patterns and state management
├── lfx-product-architect/
│ └── SKILL.md # Architecture guidance and decision trees
├── lfx-review-guard/
│ └── SKILL.md # Self-review checklist for reviewer blockers
├── lfx-preflight/
│ └── SKILL.md # Pre-PR validation and auto-fix
├── lfx-pr-catchup/
Expand Down
Loading