An agentic assistant that turns vague asks into testable requirements — and a documentation librarian that keeps a living catalog of what your internal app actually is. Designed for enterprise internal apps in the CPG industry, grounded in Claude Code, Jira, and docs-as-code on GitHub.
Two failures bleed time on every internal-app team. First, requirements arrive vague — "we need better promo visibility" — and the cost of that vagueness is paid later, as rework, missed edge cases, and three more meetings to pin down what "done" meant. Second, the documentation that would prevent that vagueness — the data model, the screens, the batch jobs, the approval rules — rots, because keeping it current is everybody's job and therefore nobody's. This guide designs an agentic system that attacks both at once: an Analyst agent that grills a fuzzy idea into a crisp Jira story using what the system already knows, and a Librarian agent that maintains that knowledge as a living, continuously-updated catalog — a wiki in the Karpathy sense, never a frozen spec.
It is built on tools you already have. Jira is the system of record for user stories. GitHub holds the documentation as code — Markdown, Mermaid, and schema files that change through pull requests — alongside the agent's own configuration. The reasoning layer is Claude Code / the Claude Agent SDK: subagents, skills like grill-me, and MCP connections to Jira and GitHub. We design the whole thing around one concrete running example: PromoDesk, an internal Trade Promotion Management app for a CPG company.
This guide ships in two layers. They tell the same story at different altitudes — read one, or both.
The problem in business terms, what changes when this exists, the ROI and the metrics to watch, the risks, and an adoption path. Code-free, one read.
The full design: agent topology, the canonical entity catalog, the elicitation skills, the Jira + GitHub wiring, and a Claude Code reference implementation. Start at chapter 1 below.
grill-me Skill buildgrill-me — and check current tool details with the provider before you ship.