aspens

LLM-powered injection of project context into installed agent templates via `aspens customize agents`

>

Core conventions, tech stack, and project structure for aspens

Claude/Codex CLI execution layer — prompt loading, stream-json parsing, file output extraction, path sanitization, skill file writing, and skill rule generation

Top-level Commander wiring, welcome screen, missing-hook warning, CliError exit handling, and the public programmatic API surface

Multi-target output system — target abstraction, backend routing, content transforms for Codex CLI and future targets

Context health analysis — freshness, domain coverage, hub surfacing, drift detection, LLM-powered interpretation, and auto-repair for generated agent context

Incremental skill updater that maps git diffs to affected skills and optionally auto-syncs via a post-commit hook

Static import analysis that builds dependency graphs, domain clusters, hub files, git churn hotspots, and file priority rankings

Deterministic repo analysis — language/framework detection, structure mapping, domain discovery, health checks, and import graph integration

Token-saving session automation — statusline, prompt guard, precompact handoffs, session rotation, and handoff commands for Claude Code

LLM-powered generation pipeline for Claude Code skills and CLAUDE.md — doc-init command, prompt system, context building, and output parsing

Bundled agents, commands, hooks, and settings that users install via `aspens add`, `aspens doc init`, and `aspens save-tokens` into their .claude/ directories

Fix compilation errors, build failures, type errors, or test failures. Systematically identifies root causes and fixes them in order.

Review code for quality, architectural consistency, and integration issues. Use after implementing features, refactoring, or before merging PRs.

Execute refactoring tasks — reorganize files, extract components, update imports, fix patterns across the codebase. Use after a refactor-planner has created a plan.

Create or update documentation — READMEs, API docs, architecture overviews, data flow diagrams, developer guides. Reads actual code first, never documents from assumptions.

Execute a development plan created by the plan agent — spawn parallel subagents per phase, test, and ship.

Write compelling, human-sounding content — landing pages, marketing copy, user docs, social media, email sequences, blog posts. Produces distinctive prose that avoids AI patterns.

Review development plans for completeness, feasibility, risks, and missed considerations before implementation begins.

Triage, analyze, and create phased development plans. Iterate with the user until the plan is approved.

Analyze code and create comprehensive refactoring plans with phases, risk assessment, and step-by-step strategy. Use BEFORE code-refactor-master executes.

UX/UI design guidance — component specs with states, accessibility audits, user flow analysis, design system recommendations. For developers building interfaces.

Research technical topics by searching the web — debug errors, compare solutions, find best practices from GitHub issues, Stack Overflow, documentation, and community resources.