Configuration

.claude/
├── product/
│   ├── index.md        # Product spec (hierarchical)
│   └── domains/        # Domain-specific specs
├── agents/             # Agent definitions
├── commands/           # Slash commands
├── skills/             # Domain skills
└── settings.json       # Hooks and permissions

.claude/product/
├── index.md              # Product overview
└── domains/
    ├── authentication/
    │   ├── index.md      # Domain overview
    │   └── features/
    │       ├── login.md
    │       └── register.md
    └── user-management/
        └── index.md

# My App
 
## Domains
- Authentication (CRITICAL)
- User Management (HIGH)

# Authentication Domain
 
## Features
 
### 1. Login - CRITICAL
**Description**: User login
 
**Acceptance Criteria**:
- [ ] Email/password input
- [ ] JWT generation

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx tsc --noEmit 2>&1 | head -5 || true"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "if [ -f .agentful/state.json ]; then jq -r '.current_phase // \"idle\"' .agentful/state.json 2>/dev/null || echo 'idle'; else echo 'idle'; fi"
          }
        ]
      }
    ]
  },
  "permissions": {
    "allow": [
      "Bash(npm:*)",
      "Bash(npx:*)",
      "Bash(node:*)",
      "Bash(git:*)",
      "Bash(jq:*)"
    ],
    "deny": [
      "Bash(rm -rf /)",
      "Bash(dd:*)",
      "Bash(mkfs:*)"
    ]
  }
}

{
  "SessionStart": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "node bin/hooks/session-start.js",
          "timeout": 3,
          "description": "Intelligent context awareness"
        }
      ]
    }
  ]
}

✅ Agentful ready (parallel execution: ON)
 
📊 Project Status: 47% complete (6/13 features)
⚠️  Architecture needs attention
⚠️  2 pending decision(s)
 
💡 Suggested next steps:
   1. ⚠️ Fix architecture → /agentful-generate
      Architecture older than package.json - may need regeneration
   2. ⚠️ Answer pending decisions → /agentful-decide
      2 decision(s) blocking progress

{
  "PreToolUse": [
    {
      "tools": ["Write", "Edit"],
      "hooks": [
        {
          "type": "command",
          "command": "node bin/hooks/block-random-docs.js",
          "timeout": 3,
          "description": "Block random markdown file creation"
        }
      ]
    }
  ]
}

# Temporary
export AGENTFUL_ALLOW_RANDOM_DOCS=true
 
# Permanent
# Remove from .claude/settings.json PreToolUse hooks

{
  "PreToolUse": [
    {
      "tools": ["Write"],
      "hooks": [
        {
          "type": "command",
          "command": "node bin/hooks/block-file-creation.js",
          "timeout": 3,
          "description": "Block arbitrary file creation"
        }
      ]
    }
  ]
}

{
  "SessionStart": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "node bin/hooks/health-check.js",
          "timeout": 5,
          "description": "Quick agentful health check"
        }
      ]
    }
  ]
}

{
  "PostToolUse": [
    {
      "matcher": "Write|Edit",
      "hooks": [
        {
          "type": "command",
          "command": "node bin/hooks/architect-drift-detector.js",
          "timeout": 3,
          "description": "Detect when architect needs to re-analyze"
        }
      ]
    }
  ]
}

{
  "PostToolUse": [
    {
      "matcher": "Write|Edit",
      "hooks": [
        {
          "type": "command",
          "command": "node bin/hooks/product-spec-watcher.js",
          "timeout": 3,
          "description": "Watch for product spec changes"
        }
      ]
    }
  ]
}

{
  "PostToolUse": [
    {
      "matcher": "Write|Edit",
      "hooks": [
        {
          "type": "command",
          "command": "node bin/hooks/analyze-trigger.js",
          "timeout": 3,
          "description": "Check if file changes warrant analysis"
        }
      ]
    }
  ]
}

{
  "PostToolUse": [
    {
      "matcher": "Write|Edit",
      "hooks": [
        {
          "type": "command",
          "command": "npx tsc --noEmit 2>&1 | head -5 || true"
        }
      ]
    }
  ]
}

// Python
{"command": "python -m mypy . 2>&1 | head -5 || true"}
 
// Go
{"command": "go build ./... 2>&1 | head -5 || true"}
 
// Disable
{"command": "echo 'Type checking disabled'"}

{
  "PostToolUse": [
    {
      "matcher": "Write|Edit",
      "hooks": [
        {
          "type": "command",
          "command": "if [ \"$FILE\" = \"*.md\" ]; then existing=$(find . -name '*.md' -not -path './node_modules/*' -not -path './.git/*' | xargs grep -l \"$(basename '$FILE' | sed 's/_/ /g' | sed 's/.md$//' | head -c 30)\" 2>/dev/null | grep -v \"$FILE\" | head -1); if [ -n \"$existing\" ]; then echo \"⚠️  Similar doc exists: $existing - consider updating instead\"; fi; fi || true"
        }
      ]
    }
  ]
}

{
  "UserPromptSubmit": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "if [ -f .agentful/state.json ]; then jq -r '.current_phase // \"idle\"' .agentful/state.json 2>/dev/null || echo 'idle'; else echo 'idle'; fi",
          "description": "Track current agentful phase"
        }
      ]
    }
  ]
}

{
  "hooks": {
    "EventType": [
      {
        "tools": ["Write", "Edit"],  // Optional: filter by tools
        "matcher": "Write|Edit",     // Optional: regex matcher
        "hooks": [
          {
            "type": "command",
            "command": "node bin/hooks/my-hook.js",
            "timeout": 3,
            "description": "What this hook does"
          }
        ]
      }
    ]
  }
}

# Disable random docs hook
export AGENTFUL_ALLOW_RANDOM_DOCS=true
claude

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          // Keep session-start, remove health-check
          {
            "type": "command",
            "command": "node bin/hooks/session-start.js",
            "timeout": 3
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "tools": ["Write", "Edit"],
        "hooks": [
          // Remove block-random-docs to allow any markdown file
        ]
      }
    ]
  }
}

"allow": [
  "Bash(npm:*)",
  "Bash(pnpm:*)",     // Add pnpm
  "Bash(yarn:*)",     // Add yarn
  "Bash(python:*)",   // Add Python
  "Bash(docker:*)"    // Add Docker
]

"deny": [
  "Bash(rm -rf /)",   // Prevent root deletion
  "Bash(dd:*)",       // Prevent disk ops
  "Bash(mkfs:*)"      // Prevent formatting
]

## Your Scope
 
- **UI Components** - Reusable components
- **Pages** - Route pages
- **Animation** - Framer Motion, GSAP  ← NEW

## NOT Your Scope
 
- State Management → @state-manager  ← DELEGATE

## Quality Gates
 
- All tests passing
- No type errors
- Test coverage ≥ 80%
- Bundle size < 200KB (gzip)  ← NEW
- Lighthouse score ≥ 90       ← NEW

---
name: database
version: 1.0.0
---
 
# Database Agent
 
You are the **Database Agent**. You handle database operations.
 
## Your Scope
 
- Schema Design - Models and relationships
- Migrations - Database migrations
- Queries - Complex queries
- Seeding - Test data
 
## NOT Your Scope
 
- API routes → @backend
- Tests → @tester
 
## Rules
 
1. ALWAYS use TypeScript
2. ALWAYS create migrations for schema changes
3. ALWAYS use transactions for multi-step operations
4. NEVER expose raw queries to API
 
## After Implementation
 
Report:
- Schemas created/modified
- Migrations run
- What needs testing

@database, please create the User model

---
name: agentful-deploy
description: Deploy project to production
---
 
# Deploy Command
 
Deploys after validation.
 
## Usage

 
## What It Does
 
1. Runs validation (`/agentful-validate`)
2. Checks quality gates
3. Runs build
4. Deploys to platform
5. Runs smoke tests
 
## Requirements
 
- All quality gates pass
- Build succeeds
- No uncommitted changes
 
## Platforms
 
- Vercel: `vercel deploy --prod`
- Netlify: `netlify deploy --prod`
- Railway: `railway up`
- Custom: `npm run deploy`
 
## Configuration
 
Add to .claude/product/index.md:
```markdown
## Deployment
- Platform: Vercel
- Build Command: npm run build
- Output Directory: .next

 
Use with:

 
## Skills Configuration
 
**Location**: `.claude/skills/`
 
### Create Testing Skill
 
**File**: `.claude/skills/testing/SKILL.md`
 
```markdown
---
name: testing
version: 1.0.0
---
 
# Testing Skill
 
Provides testing capabilities.
 
## What This Skill Does
 
- Writes unit tests
- Writes integration tests
- Writes E2E tests
- Measures coverage
 
## Usage

 
## Test Templates
 
### Unit Test (Vitest)
 
```typescript
import { describe, it, expect } from 'vitest';
import { UserService } from '../UserService';
 
describe('UserService', () => {
  it('should create a user', async () => {
    const user = await UserService.create({
      email: 'test@example.com',
      name: 'Test User'
    });
 
    expect(user).toHaveProperty('id');
    expect(user.email).toBe('test@example.com');
  });
});

 
## Platform-Specific Configuration
 
### Next.js
 
**next.config.js**:
```javascript
const nextConfig = {
  reactStrictMode: true,
  swcMinify: true,
  images: {
    domains: ['example.com'],
  },
  experimental: {
    serverActions: true,
  },
}
 
module.exports = nextConfig

{
  "compilerOptions": {
    "target": "ES2020",
    "lib": ["dom", "dom.iterable", "esnext"],
    "strict": true,
    "noEmit": true,
    "esModuleInterop": true,
    "module": "esnext",
    "moduleResolution": "bundler",
    "jsx": "preserve",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "include": ["**/*.ts", "**/*.tsx"],
  "exclude": ["node_modules"]
}

## Coverage Thresholds
 
- Overall: ≥ 80%
- Critical paths: ≥ 90%
- UI components: ≥ 70%
- Utilities: ≥ 95%

// vitest.config.ts
export default defineConfig({
  test: {
    coverage: {
      provider: 'v8',
      thresholds: {
        lines: 80,
        functions: 80,
        branches: 80,
        statements: 80,
      },
    },
  },
})

exit
claude

ls -la .claude/agents/
ls -la .claude/commands/
ls -la .claude/settings.json

ls .claude/agents/
# Reference: @database (not @database.md)

git add .claude/
git commit -m "Configure agentful"

# Already in .gitignore
.agentful/

# agentful Configuration
 
## Custom Agents
- @database - Database operations
- @analytics - Analytics tracking
 
## Custom Commands
- /agentful-deploy - Deployment workflow
 
## Modified Agents
- @frontend - Added animation support
- @reviewer - Added bundle size checks