pfftdammitchris

CLAUDE.md - Confidence Reporting

For technical decisions, report confidence:

• HIGH (90%+): Documented best practice, matches codebase patterns
• MEDIUM (60-89%): Reasonable approach, alternatives exist
• LOW (<60%): Best guess, recommend verification

When confidence < 80%, state:

pfftdammitchris

CLAUDE.md - Context Transparency

At conversation start, report:

1. Files auto-loaded into context
2. Why each was loaded
3. Approximate token usage

When reading additional files, note context window impact. Recommend fresh session when context exceeds 50% capacity.

pfftdammitchris

.claude/
├── CLAUDE.md              # Project overview (keep <200 lines)
└── rules/
    ├── api-design.md      # REST conventions, response formats
    ├── testing.md         # Test patterns, mocking strategies
    ├── react-patterns.md  # Component structure, hooks rules
    ├── database.md        # Query patterns, migration format
    └── security.md        # Auth patterns, input validation

pfftdammitchris

CLAUDE.md - Phase-Based Implementation

When planning implementation:

1. Present the plan to the user
2. Ask: "Should we convert this to a PRD with phases, or keep as a plan?"
3. If PRD: Break into phases, validate each phase before next
4. If plan: Proceed with full implementation, but track phase context

Benefits: Errors caught at phase boundaries, easier debugging, clearer accountability

pfftdammitchris

// packages/eslint-plugin/rules/no-raw-html-elements.js
const FORBIDDEN_ELEMENTS = {
  button: 'Button',
  input: 'Input or PasswordInput',
  select: 'Select',
  textarea: 'Textarea',
  h1: 'H1',
  h2: 'H2',
  h3: 'H3',
  h4: 'H4',

pfftdammitchris

// eslint.config.js
export default [
  {
    rules: {
      'custom/no-raw-html-elements': 'error',
    },
  },
]

pfftdammitchris

CLAUDE.md - Patterns to NEVER Use

❌ NEVER:

• any type (use unknown + type guards)
• console.log for errors (use console.error)
• Nested ternaries > 2 levels
• setTimeout for non-delay purposes
• Array index as React key for dynamic lists
• eval() or Function() constructor

pfftdammitchris

CLAUDE.md - Naming Standards

Files:

• Components: PascalCase.tsx
• Hooks: useCamelCase.ts
• Utils: kebab-case.ts
• Types: PascalCase.types.ts

Variables:

pfftdammitchris

.claude/skills/create-api-endpoint.md

Create API Endpoint

When user says "create endpoint for {resource}":

1. Create src/app/api/{resource}/route.ts
2. Add Zod schema: src/schemas/{resource}.ts
3. Add types: src/types/{resource}.ts
4. Create test: __tests__/api/{resource}.test.ts

pfftdammitchris

Context Handoff - 2026-01-15

Current Project / Plan

Building Medium publishing automation for jsmanifest blog

Current Phase

Database schema complete, API endpoints in progress

Work Completed This Session

• Created Supabase migration for medium_drafts table