adrielp/ai-engineering-harness

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Create well-structured git commits for changes made during the session.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Create detailed, actionable implementation plans through an interactive, iterative process.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Debug Kubernetes issues by examining pods, logs, events, and cluster state.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Debug issues during manual testing or implementation by examining logs, state, and git history.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Write, refactor, restructure, edit, or audit technical documentation using the Diátaxis framework (tutorials, how-to guides, reference, explanation). Produces clear, concise, scannable docs and fights the default tendency toward bloated, over-explained AI prose. Use this skill for ANY documentation work — README and…

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Handles experimental features that lack proper ticketing by retroactively creating Linear tickets and PRs from commits. Use when user has made commits without tickets, mentions "founder mode", or asks to formalize experimental work.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Creates well-structured git commits by analyzing changes, drafting messages, and executing commits. Use when the user asks to commit changes, save work, create a commit, or mentions committing their code.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Query GitHub for pull requests, issues, notifications, and project boards using the gh CLI. Use this skill whenever the user asks about their GitHub activity, PRs needing review, open issues, project board status, or wants to summarize GitHub conversations. Trigger on phrases like: "what PRs need my attention", "show…

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Implement an approved technical plan from thoughts/plans/ with phase-by-phase execution.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Explore a codebase to find architectural friction, propose deep-module refactors as RFC issues. Use when the user wants to improve architecture, find refactoring opportunities, deepen shallow modules, or make a codebase more AI-navigable and testable.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Initialize the AI Engineering Harness in a repository by creating CLAUDE.md and thoughts/ directory structure.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Interview the user relentlessly about a plan or design until reaching shared understanding. Walks down each branch of the decision tree, resolving dependencies one-by-one. Use when the user wants to stress-test a plan, asks to be interviewed, says "drill in", "ask me questions", or wants to validate design decisions…

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Observability Driven Development (ODD) — design the trace before the feature. Auto-activates when the user wants to "drive with observability", "ODD", "instrument first", "narrative-first", "telemetry-driven", or wants to set up a local OTel feedback loop with the Aspire dashboard. Pairs with /validatetelemetry to…

adrielp/ai-engineering-harness

Skill Claude CodeCodex

OpenTelemetry Collector configuration — receivers, processors, exporters, pipelines, sampling, deployment. Covers OTLP, Prometheus, filelog, hostmetrics; processor ordering; pipeline design; head/tail sampling; and RED metric derivation via signaltometrics.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

OpenTelemetry orchestrator — auto-activates on observability, telemetry, tracing, metrics, logging, OTel SDK, Collector, semantic conventions, or OTTL requests. Routes to the correct sub-skill.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Application-side OpenTelemetry SDK setup — traces, metrics, structured logging across Node.js, Go, Python, Java, .NET, Ruby. Prescriptive guidance for resource attributes, span design, metric instrument selection, sensitive data handling, and validation.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

OTTL (OpenTelemetry Transformation Language) reference — syntax, contexts, common patterns (redaction, normalization, enrichment, filtering), error handling, and complete function reference for Collector processors.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

OpenTelemetry semantic conventions — attribute naming, placement across telemetry levels, stability/versioning, legacy→current migration, and registry namespace reference.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Generates comprehensive pull request descriptions following repository templates. Use when creating or updating PR descriptions, when user mentions pull requests, or when asked to describe changes for review.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Break a PRD into independently-workable, vertical-slice issues written as local markdown files in issues/. Use when the user wants to turn a PRD into a list of concrete, demoable tasks ordered by dependencies.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Conduct comprehensive codebase research by spawning parallel sub-agents and synthesizing findings.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", asks for test-first development, or wants integration-style tests that survive refactors.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Validate that an implementation plan was correctly executed, verifying all success criteria.

adrielp/ai-engineering-harness

Skill Claude CodeCodex

Validate locally-emitted telemetry against a written narrative spec, or run a generic health check on the local OTel stack. Delegates to the observability-driven-development skill's Validation section.