Agentic Dev Kit (ADK)

Token-Optimized, Modular AI Agent Rules & Tri-Tier Memory Protocol for Modern Engineering.

🌟 Highlights

• Token Efficiency First: All rules/skills are kept under 50-150 lines with frontmatter-based lazy loading.
• Automated Code Quality: Includes strict code conventions, senior code review checklist, and frontend core principles.
• Dual-Zone Tri-Tier Memory:
  • 🔒 .agents/local/HANDOFF.md: Private, isolated local session handoff (automatically ignored by Git).
  • 🌐 .agents/knowledge/: Shared team architecture index, ADRs (architecture.md), and issue post-mortems (resolved-issues.md).
• Learning & Mastery Engine: Accelerated tech learning via 80/20 Roadmaps, Labs, Mental Model Mapping, and 3-Question 60s Rapid Blitz Quizzes.
• CLI Installer: Easily initialize via npx agentic-dev-kit or npx agentic-dev-kit@latest init.

🚀 Quick Start

1. Project Initialization via NPX

Inside any project repository, run:

npx agentic-dev-kit@latest init

2. Learning Mode Activation

To learn any new technology or language:

I want to learn Golang. My current background is TypeScript/React. Activate learning-mastery skill.

📂 Repository Structure

agentic-dev-kit/
├── AGENTS.md                  # Master Agent Entrypoint & Shortcut Helpers
├── bin/cli.js                 # CLI auto-installer script for npx
├── package.json               # NPM package configuration
├── examples/
│   └── prompt-playbook.md     # High-efficiency English prompt patterns & shortcuts
├── rules/                     # Core system rules (< 150 lines each)
│   ├── code-convention.md     # Naming, Guard Clauses, Strict Types, Error Handling
│   ├── code-review.md         # 5-point automated code review checklist
│   ├── frontend-core.md       # Framework-agnostic frontend principles
│   └── memory-management.md   # Memory lifecycle & self-pruning rules
├── skills/                    # Domain skills (Lazy loaded)
│   ├── business-analysis/     # Problem Framing, BRD/SRS, BPMN 2.0 & Traceability
│   ├── learning-mastery/      # Accelerated learning, Mental Mapping & 3-Q 60s Micro-Quiz
│   ├── angular/               # Angular 17+, standalone components, signals, routing & RxJS
│   ├── nodejs/                # Node.js backend, Express/Fastify, Zod, Async Safety
│   ├── nestjs/                # NestJS modular architecture, DI, Swagger, Filters
│   ├── react-next/            # Next.js App Router, RSC & Server Actions
│   ├── vue-nuxt/              # Vue 3 Composition API & Nuxt 3
│   ├── react-native/          # Mobile Expo & Performance
│   ├── rust-wasm/             # Rust & WebAssembly bindings
│   ├── python-fastapi/        # Python 3.11+, FastAPI, Pydantic v2
│   ├── tailwind-styling/      # TailwindCSS, dark mode, design tokens
│   └── testing/               # Vitest, Jest, unit & integration tests
├── templates/
│   └── .agents/               # Dual-Zone Memory template
│       ├── .gitignore         # Ignores local/ automatically
│       ├── local/HANDOFF.md   # Private active session handoff
│       └── knowledge/         # Shared team index, ADRs & resolved issues
└── scripts/
    └── install.sh             # 1-Click bash installer script