Skip to content
Open
Show file tree
Hide file tree
Changes from 2 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
73 changes: 45 additions & 28 deletions .claude/rules/skill-guidance.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,44 +5,61 @@ globs: '*'

# Available Skills

This project has guided skills for common workflows. **Proactively suggest the relevant skill** when a user's request matches one of these:
This project has guided skills for `apps/lfx` (the primary app). **Proactively suggest the relevant skill** when a user's request matches one of these.

| Skill | When to Suggest |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| `/setup` | Getting started, first-time setup, broken environments, install failures, missing env vars, 1Password, how to run the app |
| `/develop` | Add a feature, fix a bug, modify code, create components/services/endpoints/types, refactor, build, implement any code change |
| `/preflight` | Before submitting a PR, check if code is ready, validate changes, verify a branch, finished development, review readiness |
---

## Trigger Phrases
## Skills for `apps/lfx` (new app — primary focus)

**`/setup`** — match any of these intents:
| Skill | When to Suggest |
| ------------------ | --------------------------------------------------------------------------------------- |
| `/lfx-setup` | Getting started with `apps/lfx`, first-time setup, broken environment, install failures |
| `/lfx-coordinator` | Add a feature, fix a bug, modify code, implement anything in `apps/lfx` |
| `/lfx-design` | Create a new base UI component, add a variant, work with Tailwind v4 design tokens |
| `/lfx-research` | Validate an upstream API, explore what endpoints exist before building |
| `/lfx-preflight` | Before submitting a PR for `apps/lfx` — lint, build, license headers |

- "How do I set up?", "Getting started", "First time here"
- "yarn install fails", "corepack error", "node version"
- "env vars", "1Password", "app won't start"
- "broken environment", "fresh install", "missing dependencies"
### Trigger Phrases (apps/lfx)

**`/develop`** — match any of these intents:
**`/lfx-coordinator`** — any code change in `apps/lfx`:

- "Add a feature", "Create a component", "Build an endpoint"
- "Fix this bug", "Modify the service", "Update the page"
- "Refactor", "Implement", "Change the behavior"
- "New interface", "Add a filter", "Create a form"
- Describes any code change, feature request, or bug fix
- Any feature request, bug fix, or code change in the new app

**`/preflight`** — match any of these intents:
**`/lfx-design`** — new base UI components:

- "Ready for PR", "Check my code", "Validate changes"
- "Before I submit", "Is my branch ready?", "Review my work"
- "Run checks", "Lint and build", "Pre-PR validation"
- Any indication that development work is finished
- "Create a button/input/card/modal/badge"
- "Add a variant to the component"
- "Build a design system component"
- "Tailwind v4 component"

## For Cowork Sessions
**`/lfx-research`** — upstream API exploration before building:

- "Does the upstream API support X?"
- "What endpoints does the committee service have?"
- "What fields are in the meeting response?"

Non-developer contributors use these skills as guided workflows. Follow these rules:
**`/lfx-preflight`** — after work in `apps/lfx`:

- "Ready for PR", "Check my code", "Validate changes", "Lint and build"

---

## Skill Relationships (apps/lfx)

```text
/lfx-coordinator ──delegates──▶ /lfx-research
/lfx-backend-builder
/lfx-ui-builder
/lfx-design
```
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Outdated

The coordinator is the entry point for all feature work in `apps/lfx`. For anything spanning more than one layer, always use `/lfx-coordinator`.

## For Cowork Sessions

- If the user describes a feature they want to build, suggest `/develop` — it walks them through the full process step-by-step
- If the user asks about setup or getting started, suggest `/setup`
- After any development work is complete, remind them to run `/preflight` before creating a PR
- If you are unsure which skill applies, ask the user what they're trying to accomplish
- When a skill references architecture docs in `docs/`, read those docs before generating code — they are the source of truth
- Contributor describes a feature → suggest `/lfx-coordinator`
- Setup questions → suggest `/lfx-setup`
- After development work → remind to run `/lfx-preflight`
- When a skill references architecture docs in `docs/`, read those docs before generating code
248 changes: 0 additions & 248 deletions .claude/skills/develop/SKILL.md

This file was deleted.

14 changes: 0 additions & 14 deletions .claude/skills/develop/evals/evals.json

This file was deleted.

Loading
Loading