claude-setup

Here’s a reusable Claude Code configuration for a TypeScript project named **`acme-sales-workflow`**, designed to streamline development with Sortd (ai-assistant) integration and guardrails for AI agents:

---

### **Project Structure**
```
acme-sales-workflow/
├── .claudeignore          # Files/paths ignored by Claude
├── .eslintrc.json         # ESLint configuration
├── .prettierrc            # Prettier configuration
├── package.json           # Project metadata and scripts
├── src/
│   ├── index.ts           # Entry point
│   ├── types/
│   │   └── sortd.d.ts     # TypeScript definitions for Sortd API
│   ├── utils/
│   │   └── sortd-client.ts # Wrapper for Sortd API calls
│   └── agents/
│       └── sales-agent.ts # AI agent for sales workflows
├── tests/
│   ├── unit/
│   │   └── sortd-client.test.ts
│   └── integration/
│       └── sales-agent.test.ts
└── config/
    └── claude-config.json # Claude-specific settings
```

---

### **package.json**
```json
{
  "name": "acme-sales-workflow",
  "version": "1.0.0",
  "description": "TypeScript project for Sortd-integrated sales workflows",
  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js",
    "test": "jest",
    "lint": "eslint . --ext .ts",
    "format": "prettier --write ."
  },
  "dependencies": {
    "@sortd/ai-assistant": "^2.1.0",
    "axios": "^1.6.2",
    "typescript": "^5.0.0"
  },
  "devDependencies": {
    "@types/node": "^20.0.0",
    "@typescript-eslint/eslint-plugin": "^6.0.0",
    "@typescript-eslint/parser": "^6.0.0",
    "eslint": "^8.0.0",
    "jest": "^29.0.0",
    "prettier": "^3.0.0",
    "ts-jest": "^29.0.0"
  }
}
```

---

### **Guardrails for AI Agents**
Add this to `.claudeignore` to prevent accidental modifications:
```
# Ignore Sortd API keys and sensitive files
.env
*.key
config/local/*

# Ignore generated files
dist/
tests/__snapshots__/

# Ignore large datasets
*.csv
*.jsonl
```

---

### **ESLint Configuration (.eslintrc.json)**
```json
{
  "root": true,
  "parser": "@typescript-eslint/parser",
  "plugins": ["@typescript-eslint"],
  "extends": [
    "eslint:recommended",
    "plugin:@typescript-eslint/recommended"
  ],
  "rules": {
    "@typescript-eslint/no-explicit-any": "error",
    "@typescript-eslint/explicit-module-boundary-types": "error",
    "no-console": "warn"
  }
}
```

---

### **Prettier Configuration (.prettierrc)**
```json
{
  "semi": false,
  "singleQuote": true,
  "tabWidth": 2,
  "trailingComma": "es5",
  "printWidth": 100
}
```

---

### **Claude-Specific Settings (config/claude-config.json)**
```json
{
  "allowed_directories": ["src", "tests"],
  "disallowed_directories": ["node_modules", "dist"],
  "ai_guardrails": {
    "max_file_size": 1048576,
    "max_lines_per_file": 500,
    "forbidden_patterns": [
      "eval(",
      "child_process.exec(",
      "fs.writeFileSync("
    ]
  }
}
```

---

### **Key Features**
1. **Type Safety**: Pre-configured TypeScript with strict rules for Sortd API interactions.
2. **Consistent Style**: ESLint + Prettier enforce uniform code formatting.
3. **AI Guardrails**: Prevents risky operations (e.g., file deletions, eval calls).
4. **Test-Ready**: Jest setup for unit/integration tests with Sortd mocks.
5. **Sortd Integration**: Dedicated `sortd-client.ts` wrapper for API calls.

---

### **How to Use**
1. **Initialize**: Run `npx claude-setup --name acme-sales-workflow` to scaffold the project.
2. **Customize**: Replace `acme-sales-workflow` with your project name and update dependencies in `package.json`.
3. **Develop**: Use `npm run dev` (add a script if needed) to start coding with guardrails active.
4. **Test**: Run `npm test` to validate Sortd API interactions.
5. **Deploy**: Build with `npm run build` and deploy to your preferred runtime.

**Tip**: For Sortd-specific workflows, extend the `sales-agent.ts` file to handle lead follow-ups, email templates, or kanban board updates via the Sortd API.