Skip to content

drobins25/craft / skills/lock-decision

lock-decision

Verified

This skill should be used when the user says "lock it", "go with that", "approved", "that's the standard", or explicitly establishes a project-wide pattern like "from now on all forms should use this approach". Formalizes approved decisions into locked standards that the system enforces going forward. Not needed for story-scoped decisions — only for project-wide patterns.

FileKindSize
SKILL.mdskill md5.7 KB
references/lock-templates.mdmarkdown2.8 KB

references/lock-templates.md

View on GitHub
# Lock Decision Templates

## Table of Contents
- [Design Decisions (Typed)](#design-decisions-typed)
- [Pattern Locks](#pattern-locks)
- [Token Locks](#token-locks)
- [Approach Locks](#approach-locks)

---

## Design Decisions (Typed)

For structured UI decisions that Tokens Studio can render:

```markdown
### [Decision Name]
**Type:** layout | component | density | visibility
**Choice:** [key]
```

**Valid keys by type:**

| Type | Valid Keys |
|------|------------|
| `layout` | list, cards, table, grid, bento, sidebar, topnav, tabs, gallery |
| `component` | modal, inline, drawer, dropdown, pills, tabs, accordion, toggle, readonly |
| `density` | compact, comfortable, spacious |
| `visibility` | minimal, rich, full |

**Example:**
```markdown
### Task Display
**Type:** layout
**Choice:** cards

### Priority Selector
**Type:** component
**Choice:** pills

### Dashboard Density
**Type:** density
**Choice:** comfortable
```

> Tokens Studio renders these as a visual showcase. User changes decisions by asking — not through UI.

---

## Pattern Locks

For UI patterns that should be consistent:

```markdown
## Locked Pattern: Primary Button

**Locked:** 2024-01-15

### Specification
- Background: `primary` token
- Text: `white`
- Padding: `12px 24px`
- Border radius: `8px`
- Font: `medium` weight

### States
- Hover: `primary-dark` background
- Active: Scale 0.98
- Disabled: 50% opacity, no pointer events
- Loading: Spinner replaces text

### Variants
- `size="sm"` — Padding `8px 16px`, font size `14px`
- `size="lg"` — Padding `16px 32px`, font size `18px`

### Usage Rules
- One primary button per view
- Always has explicit label (no icon-only primary)
- Loading state required for async actions
```

---

## Token Locks

For design values that are final:

```markdown
## Locked Tokens

### Colors (Locked 2024-01-15)
| Token | Value | Usage |
|-------|-------|-------|
| `primary` | `#6366F1` | Main actions, links |
| `primary-dark` | `#4F46E5` | Hover states |
| `surface` | `#FAFAFA` | Backgrounds |

### Spacing Scale (Locked 2024-01-15)
`4, 8, 12, 16, 24, 32, 48, 64`

No arbitrary values. If you need something else, propose a token.
```

---

## Approach Locks

For technical decisions:

```markdown
## Locked Approach: Data Fetching

**Locked:** 2024-01-15
**Applies to:** All data fetching in the application

### Decision
Use React Query (TanStack Query) for all server state.

### Rationale
- Built-in caching and invalidation
- Optimistic updates
- DevTools for debugging
- Team familiarity

### Implementation Standard
```tsx
// All queries must follow this pattern
const { data, isLoading, error } = useQuery({
  queryKey: ['resource', id],
  queryFn: () => fetchResource(id),
  staleTime: 5 * 60 * 1000, // 5 minutes
});
```

### Not Allowed
- Direct fetch() calls for server data
- useEffect for data fetching
- Custom caching solutions
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall