Agent Context Bundles

Deep context bundles for Claude Code. Load a stack, skip the ramp-up.

Context bundles give Claude Code instant operational knowledge for a technology stack -- architecture patterns, correct idioms, copy-paste commands, and real failure modes. Instead of Claude rediscovering your framework's quirks through trial and error, load a bundle and get expert-level output from the first prompt.

Install

Supported install path:

npx skills add puretensor/agent-context-bundles

Optional global install:

npx skills add puretensor/agent-context-bundles -g

No manual clone instructions are documented here; the supported path is the tested skills installer flow above.

Usage

/ctx nestjs              # Load a bundle
/ctx fastapi postgresql  # Load multiple bundles
/ctx catalog             # Browse shipped community bundles
/ctx install nestjs      # Copy to ~/.claude/contexts/ and add project-state sections
/ctx update myproject    # Update a local project bundle after a work session
/ctx new myproject ~/src # Create a new project bundle from a codebase
/ctx list                # List local + community bundles
/ctx show nestjs         # Preview without loading

Available Bundles

Bundle	Stack	What it covers
nestjs	NestJS + TypeScript	Decorators, DI, module patterns, testing, circular dep fixes
spring-boot	Spring Boot + Java	Annotations, JPA, profiles, transactional gotchas, testing
postgresql	PostgreSQL	Index strategy, EXPLAIN ANALYZE, query antipatterns, tuning
react-nextjs	Next.js App Router	Server vs Client Components, data fetching, routing conventions
fastapi	FastAPI + Python	Pydantic v2, async patterns, dependency injection, testing
kubernetes	Kubernetes Ops	kubectl patterns, Helm, debugging, resource limits, HPA
aws-lambda	AWS Serverless	SAM/CDK, cold starts, layers, event sources, monitoring
django	Django + Python	ORM gotchas, DRF, migrations, Celery, admin patterns
rails	Ruby on Rails	ActiveRecord, Hotwire/Turbo, RSpec, convention patterns
golang-api	Go API Services	Project layout, error handling, goroutines, stdlib patterns
docker-compose	Docker Compose	Multi-service dev, volumes, networking, health checks
github-actions	GitHub Actions CI/CD	Workflows, matrix builds, caching, reusable workflows
rust-cli	Rust CLI Tools	Clap, error handling, async runtime, cross-compilation
flutter	Flutter Mobile	Widgets, state management, navigation, platform channels

How It Works

Claude Code gets two kinds of bundle context from /ctx:

Type	Location	Purpose
Community bundles	Installed inside the ctx skill	Static stack briefings for frameworks and platforms
User bundles	~/.claude/contexts/	Project-specific bundles that evolve with your work

Community bundles are shipped with the skill and are ready to load immediately. User bundles take priority when names conflict.

/ctx install <name> copies a community bundle into ~/.claude/contexts/ and adds project-state sections so it can be maintained over time with /ctx update.

Community vs Project Bundles

Community bundles are optimized for fast stack ramp-up. They typically contain:

• Architecture
• Key Files
• One or more stack-specific pattern sections
• Common Operations
• Gotchas
• Cross-References

Project bundles often add:

• Current State
• Configuration
• Recent Changes

Use /ctx new <name> <path> to create a project-specific bundle from scratch, or /ctx install <name> to turn a shipped community bundle into a local project bundle.

Validation

npm run validate
npm run smoke-test

• validate checks bundle structure, descriptions, gotcha count, and dead cross-references.
• smoke-test verifies that npx skills add installs a self-contained ctx skill with its bundled assets.

Security and privacy

This repository ships generic community context bundles only. Do not add private hostnames, credentials, internal runbooks, customer data, personal data, or project-specific secrets to community bundles. Use local user bundles under ~/.claude/contexts/ for private project state.

License

MIT