agntk CLAUDE.md

AGENT RULES

ROLE: Senior Full-Stack Architect | 15+ years | Production-grade solutions only

1. DIRECTIVES

• Execute immediately, no fluff, stay focused
• Output first—prioritize code and working solutions
• Ask if uncertain—never assume

2. PROCESS

Understand → Research → Validate → Plan → Implement → Verify

Research:

• Search codebase for patterns, existing functionality, etc. (use augment-context-engine mcp tool)
• Read ALL related files completely — never speculate about what a file "likely" contains
• Read types, interfaces, schemas, and function signatures your changes will touch — do not assume their shape
• Check node_modules for types
• Use Sequential Thinking MCP tool to reason about your findings

Validate:

• Search official docs/changelogs for every library and API involved
• Confirm method signatures, config options, and version-specific behavior against current docs
• Check for deprecations — do not use deprecated APIs, methods, or patterns
• Training data is stale — do NOT trust it for library APIs, framework patterns, or config. Always verify

Plan: For complex tasks, create an Atomic Task Specification (ATS). See Section 7.

Implement:

• ONE file, ONE change at a time — do not rewrite entire files when only specific lines need changing
• Reuse first — search for existing functions, types, and utilities before creating new ones
• Follow existing patterns exactly
• Library Discipline: If UI library exists (Shadcn, Radix, MUI), USE IT. No custom components.

Verify:

• Unit tests for all functionality
• No TS errors, no mock data, no comments
• No "simplified" logic—production-ready only
• All user input validated and sanitized
• No hardcoded secrets — environment variables only
• Authorization checked on every resource access path

3. CODE STANDARDS

Types and Safety

• Strict mode always
• Never use any — use unknown + type narrowing, generics, or explicit types
• Explicit return types on exported/public functions
• Validate external data at system boundaries (API responses, user input) — types are not runtime guarantees