@codihaus/claude-skills 1.6.6 → 1.6.7

package/skills/dev-specs/references/checklist.md

@@ -1,176 +0,0 @@
-# Spec Completeness Checklist
-
-Use this to verify specs are implementation-ready.
-
-## Shared Specs
-
-### data-model.md
-
-- [ ] All new entities defined with fields
-- [ ] Field types specified
-- [ ] Constraints documented (NOT NULL, UNIQUE, FK)
-- [ ] Relationships described
-- [ ] Migrations provided (up + down)
-- [ ] Indexes identified
-- [ ] Seed data (if applicable)
-
-### patterns.md
-
-- [ ] Code style conventions listed
-- [ ] File naming conventions
-- [ ] Error handling patterns
-- [ ] Logging patterns
-- [ ] API patterns (if applicable)
-- [ ] State patterns (if applicable)
-- [ ] Links to existing examples in codebase
-
-### security.md
-
-- [ ] Authentication requirements
-- [ ] Authorization/permission model
-- [ ] Input validation rules
-- [ ] Sensitive data handling
-- [ ] Rate limiting (if applicable)
-- [ ] Audit logging (if applicable)
-
-## Per-UC Specs
-
-### README.md (Implementation Plan)
-
-**Context:**
-- [ ] Links to BRD use case
-- [ ] Links to feature scout
-- [ ] Status marked
-
-**Requirements:**
-- [ ] Business requirements summarized
-- [ ] Acceptance criteria listed
-- [ ] Business rules included
-
-**Current State:**
-- [ ] What exists documented
-- [ ] Gaps identified
-
-**Implementation:**
-- [ ] Step-by-step plan
-- [ ] Clear sequence
-- [ ] No ambiguity
-
-**API Contract (if applicable):**
-- [ ] Method and endpoint
-- [ ] Request format with example
-- [ ] Response format with example
-- [ ] All error codes listed
-- [ ] Authentication requirements
-
-**UI (if applicable):**
-- [ ] Components listed
-- [ ] Props defined
-- [ ] State described
-- [ ] User interactions mapped
-
-**Edge Cases:**
-- [ ] Edge cases identified
-- [ ] Handling described for each
-
-**Dependencies:**
-- [ ] Dependencies on other UCs listed
-- [ ] Dependencies on shared specs listed
-- [ ] External dependencies noted
-
-**Acceptance Mapping:**
-- [ ] Each BRD criterion mapped to implementation
-
-### changes.md
-
-- [ ] All new files listed with purpose
-- [ ] All modified files listed with change
-- [ ] File paths are correct
-- [ ] File tree preview included
-- [ ] Nothing missing
-
-### tests.md
-
-**Coverage:**
-- [ ] Unit tests planned
-- [ ] Integration tests planned
-- [ ] E2E tests planned (if applicable)
-
-**Test Cases:**
-- [ ] Happy path covered
-- [ ] Error cases covered
-- [ ] Edge cases covered
-- [ ] Auth/permission cases (if applicable)
-
-**Test Data:**
-- [ ] Sample data provided
-- [ ] Mock data defined
-
-**Coverage Target:**
-- [ ] Target defined
-- [ ] Realistic for scope
-
-## Specs Index (README.md)
-
-- [ ] All UCs listed
-- [ ] Implementation order defined
-- [ ] Dependencies shown
-- [ ] Mermaid graph (if complex)
-- [ ] Summary metrics
-- [ ] Notes/risks documented
-
-## Quality Checks
-
-### Clarity
-- [ ] Can be understood without additional context
-- [ ] No ambiguous language ("maybe", "probably", "might")
-- [ ] Technical terms defined or linked
-
-### Completeness
-- [ ] All acceptance criteria addressed
-- [ ] No TODOs or placeholders
-- [ ] All edge cases considered
-
-### Consistency
-- [ ] Naming matches codebase conventions
-- [ ] Matches patterns from scout
-- [ ] File paths follow project structure
-
-### Feasibility
-- [ ] No impossible requirements
-- [ ] Dependencies are available
-- [ ] Aligns with existing architecture
-
-## Red Flags
-
-Watch for these issues:
-
-| Issue | Problem |
-|-------|---------|
-| "TBD" or "TODO" | Incomplete spec |
-| No error handling | Missing edge cases |
-| No tests planned | Quality risk |
-| Circular dependencies | Architecture issue |
-| No acceptance mapping | Requirements disconnect |
-| Hardcoded values | Config missing |
-| No validation | Security risk |
-
-## Review Questions
-
-Before finalizing, answer:
-
-1. **Can an engineer implement this without asking questions?**
-2. **Are all acceptance criteria traceable to implementation?**
-3. **Is the scope clear - what's in/out?**
-4. **Are dependencies identified and available?**
-5. **Will tests verify the requirements?**
-6. **Are edge cases and errors handled?**
-
-## Approval Checklist
-
-| Role | Check |
-|------|-------|
-| Author | All sections complete |
-| Tech Lead | Architecture aligned |
-| Product | Requirements mapped |
-| QA | Tests adequate |

package/skills/dev-specs/references/spec-templates.md

@@ -1,460 +0,0 @@
-# Spec Templates
-
-Templates for different implementation types.
-
-## Backend API Spec
-
-For API/service implementations:
-
-```markdown
-# UC-{GROUP}-{NNN}: {Title}
-
-> **Type**: Backend API
-> **BRD**: [→](../../../brd/use-cases/UC-XXX-NNN.md)
-
-## Endpoint
-
-`{METHOD} /api/{path}`
-
-## Authentication
-- [ ] Public
-- [ ] Requires auth token
-- [ ] Requires specific role: {role}
-
-## Request
-
-### Headers
-| Header | Value | Required |
-|--------|-------|----------|
-| Authorization | Bearer {token} | Yes |
-| Content-Type | application/json | Yes |
-
-### Body
-```json
-{
-    "field": "string",
-    "field2": 123
-}
-```
-
-### Validation Rules
-| Field | Rules |
-|-------|-------|
-| field | required, string, max:255 |
-| field2 | required, integer, min:0 |
-
-## Response
-
-### Success (200)
-```json
-{
-    "success": true,
-    "data": {}
-}
-```
-
-### Errors
-| Status | Code | Message | When |
-|--------|------|---------|------|
-| 400 | VALIDATION_ERROR | Invalid input | Validation fails |
-| 401 | UNAUTHORIZED | Not authenticated | No/invalid token |
-| 403 | FORBIDDEN | Not authorized | Wrong permissions |
-| 404 | NOT_FOUND | Resource not found | ID doesn't exist |
-| 500 | SERVER_ERROR | Internal error | Unexpected error |
-
-## Database Operations
-- [ ] Read only
-- [ ] Creates records
-- [ ] Updates records
-- [ ] Deletes records
-- [ ] Transaction required
-
-### Queries
-```sql
--- Main query
-SELECT * FROM {table} WHERE ...
-```
-
-## Business Logic
-
-1. Validate input
-2. Check permissions
-3. {Core logic}
-4. Return response
-
-## Edge Cases
-- {Edge case 1}: {How to handle}
-- {Edge case 2}: {How to handle}
-
-## Tests
-
-### Unit
-- [ ] Validation: valid input accepted
-- [ ] Validation: invalid input rejected
-- [ ] Logic: {core logic test}
-
-### Integration
-- [ ] Success path
-- [ ] Auth required
-- [ ] Error cases
-```
-
-## Frontend Component Spec
-
-For UI implementations:
-
-```markdown
-# UC-{GROUP}-{NNN}: {Title}
-
-> **Type**: Frontend UI
-> **BRD**: [→](../../../brd/use-cases/UC-XXX-NNN.md)
-
-## Component
-
-**Name**: `{ComponentName}`
-**Location**: `src/components/{path}/{ComponentName}.tsx`
-
-## Props
-
-| Prop | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| prop1 | string | Yes | - | Description |
-| prop2 | number | No | 0 | Description |
-| onSubmit | (data) => void | Yes | - | Callback |
-
-## State
-
-| State | Type | Purpose |
-|-------|------|---------|
-| isLoading | boolean | Loading indicator |
-| error | string | null | Error message |
-| data | T | null | Fetched data |
-
-## API Integration
-
-| Action | Endpoint | When |
-|--------|----------|------|
-| Fetch | GET /api/x | On mount |
-| Submit | POST /api/x | On form submit |
-
-## UI Elements
-
-| Element | Type | Behavior |
-|---------|------|----------|
-| Email input | text | Required, email validation |
-| Submit button | button | Disabled while loading |
-| Error alert | alert | Shows on error |
-
-## User Interactions
-
-| Interaction | Result |
-|-------------|--------|
-| Click submit | Validate → Call API → Show result |
-| Input change | Update state, clear errors |
-
-## Loading States
-- Initial load: Show skeleton
-- Submitting: Disable form, show spinner
-- Error: Show error message, enable retry
-
-## Error Handling
-
-| Error | Display |
-|-------|---------|
-| Validation | Inline field errors |
-| API error | Toast notification |
-| Network error | Retry banner |
-
-## Accessibility
-- [ ] Keyboard navigation
-- [ ] Screen reader labels
-- [ ] Focus management
-- [ ] Error announcements
-
-## Tests
-
-### Unit
-- [ ] Renders correctly
-- [ ] Props work as expected
-- [ ] State changes correctly
-
-### Integration
-- [ ] Form submission
-- [ ] Error handling
-- [ ] Loading states
-
-### E2E
-- [ ] Full user flow
-```
-
-## Full-Stack Spec
-
-For features spanning frontend and backend:
-
-```markdown
-# UC-{GROUP}-{NNN}: {Title}
-
-> **Type**: Full-Stack
-> **BRD**: [→](../../../brd/use-cases/UC-XXX-NNN.md)
-
-## Overview
-{What this implements end-to-end}
-
-## Data Flow
-
-```mermaid
-sequenceDiagram
-    User->>Frontend: Action
-    Frontend->>API: Request
-    API->>Database: Query
-    Database-->>API: Result
-    API-->>Frontend: Response
-    Frontend-->>User: Update UI
-```
-
-## Backend
-
-### Endpoint
-`{METHOD} /api/{path}`
-
-### Handler
-```
-File: src/api/{path}.ts
-Function: handle{Action}
-```
-
-### Database
-```
-Table: {table}
-Operation: {read/write/update/delete}
-```
-
-## Frontend
-
-### Component
-```
-File: src/components/{path}.tsx
-Name: {ComponentName}
-```
-
-### State Management
-```
-Store: {store/context}
-Actions: {actions used}
-```
-
-## Implementation Sequence
-
-1. [ ] Database: Add migration
-2. [ ] Backend: Create endpoint
-3. [ ] Backend: Add tests
-4. [ ] Frontend: Create component
-5. [ ] Frontend: Integrate API
-6. [ ] Frontend: Add tests
-7. [ ] E2E: Add test
-
-## Shared Dependencies
-- {Shared types}
-- {Shared validation}
-- {Shared utilities}
-```
-
-## Mobile App Spec
-
-For mobile implementations:
-
-```markdown
-# UC-{GROUP}-{NNN}: {Title}
-
-> **Type**: Mobile
-> **BRD**: [→](../../../brd/use-cases/UC-XXX-NNN.md)
-
-## Screen
-
-**Name**: `{ScreenName}`
-**Location**: `src/screens/{path}/{ScreenName}.tsx`
-
-## Navigation
-- **From**: {Previous screen}
-- **To**: {Next screen(s)}
-- **Params**: {Route params}
-
-## Layout
-
-```
-┌─────────────────────┐
-│      Header         │
-├─────────────────────┤
-│                     │
-│      Content        │
-│                     │
-├─────────────────────┤
-│      Footer         │
-└─────────────────────┘
-```
-
-## Components
-
-| Component | Purpose |
-|-----------|---------|
-| {Name} | {Purpose} |
-
-## API Calls
-
-| Action | Endpoint | Trigger |
-|--------|----------|---------|
-| Load | GET /api/x | Screen focus |
-| Submit | POST /api/x | Button press |
-
-## Offline Handling
-- [ ] Works offline
-- [ ] Requires network
-- [ ] Queues for sync
-
-## Platform-Specific
-
-| iOS | Android |
-|-----|---------|
-| {Specific} | {Specific} |
-
-## Performance
-- [ ] List virtualization
-- [ ] Image optimization
-- [ ] Memoization
-```
-
-## Data Model Spec
-
-For database/schema changes:
-
-```markdown
-# Data Model: {Feature}
-
-## New Entities
-
-### {EntityName}
-
-| Field | Type | Constraints | Description |
-|-------|------|-------------|-------------|
-| id | uuid | PK | Primary key |
-| createdAt | timestamp | NOT NULL | Creation time |
-| updatedAt | timestamp | NOT NULL | Last update |
-| {field} | {type} | {constraints} | {description} |
-
-### Relationships
-
-```mermaid
-erDiagram
-    ENTITY1 ||--o{ ENTITY2 : has
-    ENTITY2 }|--|| ENTITY3 : belongs
-```
-
-## Migrations
-
-### Migration 001: {name}
-
-```sql
--- Up
-CREATE TABLE {table} (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    ...
-);
-
-CREATE INDEX idx_{table}_{field} ON {table}({field});
-
--- Down
-DROP TABLE {table};
-```
-
-### Migration 002: {name}
-
-```sql
--- Up
-ALTER TABLE {table} ADD COLUMN {column} {type};
-
--- Down
-ALTER TABLE {table} DROP COLUMN {column};
-```
-
-## Indexes
-
-| Table | Index | Columns | Purpose |
-|-------|-------|---------|---------|
-| {table} | idx_xxx | {cols} | {why} |
-
-## Seed Data
-
-```sql
-INSERT INTO {table} (col1, col2) VALUES
-    ('val1', 'val2'),
-    ('val3', 'val4');
-```
-```
-
-## Service/Worker Spec
-
-For background jobs, services:
-
-```markdown
-# UC-{GROUP}-{NNN}: {Title}
-
-> **Type**: Service/Worker
-> **BRD**: [→](../../../brd/use-cases/UC-XXX-NNN.md)
-
-## Service
-
-**Name**: `{ServiceName}`
-**Location**: `src/services/{path}.ts`
-
-## Trigger
-
-- [ ] Scheduled (cron)
-- [ ] Event-driven
-- [ ] Queue-based
-- [ ] Manual
-
-### Schedule
-```
-Cron: 0 * * * *  # Every hour
-```
-
-### Event
-```
-Topic: {event.topic}
-Payload: { ... }
-```
-
-## Logic
-
-1. {Step 1}
-2. {Step 2}
-3. {Step 3}
-
-## Dependencies
-
-| Service | Purpose |
-|---------|---------|
-| Database | Read/write data |
-| Queue | Publish events |
-| External API | {Purpose} |
-
-## Error Handling
-
-| Error | Action |
-|-------|--------|
-| Retryable | Retry with backoff |
-| Fatal | Log, alert, skip |
-
-## Monitoring
-
-| Metric | Type | Alert |
-|--------|------|-------|
-| Execution time | gauge | > 5min |
-| Error rate | counter | > 5% |
-| Queue depth | gauge | > 1000 |
-
-## Idempotency
-- [ ] Safe to retry
-- [ ] Deduplication key: {key}
-```