Agent-Skills.md

Agent Skills: MCAF: Developer Experience

Improve developer experience for multi-component solutions: onboarding, F5 contract, cross-platform tasks, local inner loop, and reproducible setup. Use when the repo is hard to run, debug, test, or onboard into.

UncategorizedID: managedcode/MCAF/mcaf-devex

Repository

managedcode/MCAF
managedcodeLicense: CC-BY-4.0
526

Install this agent skill to your local

pnpm dlx add-skill https://github.com/managedcode/MCAF/tree/HEAD/skills/mcaf-devex

Skill Files

Browse the full folder contents for mcaf-devex.

Download Skill

Loading file tree…

skills/mcaf-devex/SKILL.md

Skill Metadata

Name
mcaf-devex
Description
"Fix local setup, run, debug, test, or onboarding friction using reproducible repository commands. Use when contributor workflows are missing, inconsistent, or slow."

MCAF: Developer Experience

Read root/local AGENTS.md, current onboarding, scripts, service wiring, and the concrete setup failure.

Workflow

  1. Trace prerequisites through first build, real service startup, debug, tests, and cleanup. Identify the fragile step before adding tooling.
  2. Prefer the existing supported command path and real services, containers, or sandboxes. Use cross-platform or containerized setup only where it solves the observed problem.
  3. Teach MCAF-ARCH-001 with the repository map and one real canonical slice across all applicable surfaces.
  4. Teach MCAF-REQ-001 by linking that slice's requirements, acceptance, ADR decision, tasks, tests, and evidence.
  5. Complete the requested script/config/doc changes, self-review the entire path, then verify the affected setup or command in one planned phase.
  6. Explain required credentials and common failures without embedding secrets. Get approval before changing architecture, dependencies, or production topology.

Deliver a reproducible workflow and concise onboarding instructions grounded in actual commands and observed results.

References