Skip to content

ADR-0009: Add problem-intake skill for archaeology brief generation

  • Status: Accepted
  • Date: 2026-03-19
  • Deciders: DeAcero Agentic Team

Context

The software-archeologist skill receives highly variable inputs — from precise SP names to vague business questions. Without structured intake, agents waste time on clarifications or explore blindly. SQUIT MCP indexes 5.7M SQL objects with semantic search, making automatic entry-point discovery feasible.

The enhance-prompt pattern (stitch-skills) proves that an intake/enrichment layer dramatically improves downstream agent quality.

Decision

Create a new skill software/discovery/problem-intake that: 1. Accepts a vague business question in natural language 2. Queries SQUIT MCP for semantically relevant entry points (SPs, tables, views) 3. Presents candidates for user confirmation/refinement 4. Outputs a structured archaeology brief ready for software-archeologist

Graceful degradation when SQUIT is unavailable: falls back to guided manual questions.

Consequences

  • Archaeology sessions start with a richer, validated context
  • Reduces back-and-forth clarification between user and agent
  • Establishes a reusable "intake → enrich → brief" pattern for other domain skills
  • Adds a dependency on SQUIT MCP availability (non-blocking — skill degrades gracefully)