sdlc-agent-02-requirement-validation

Validates requirement packages and generates clarification questions as structured JSON artifacts on Databricks.

1|2|Updated Aug 10, 2026
One-click install
npx skills add https://github.com/TRRaveendra/AI-Agents-Databricks --skill sdlc-agent-02-requirement-validation-trraveendra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdlc-agent-02-requirement-validation
Source: https://github.com/TRRaveendra/AI-Agents-Databricks/tree/main/ai-agent-skills/databricks-sdlc-agent-skills/02-requirement-validation-agent
Command: npx skills add https://github.com/TRRaveendra/AI-Agents-Databricks --skill sdlc-agent-02-requirement-validation-trraveendra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires databricks-sdk, mlflow, and includes references (resource) components.

What problem does it solve? Software requirements arriving from upstream intake often lack clear objectives, scope, or acceptance criteria, causing downstream development agents to build on ambiguous foundations. This Skill acts as Agent 2 of 15 in a Databricks multi-agent SDLC pipeline, checking requirement completeness and emitting a validated requirement artifact with numbered clarification questions before any build work begins. ## Core Features & Use Cases - Completeness and Ambiguity Checking: Detects missing objectives, scope gaps, and under-specified acceptance criteria against retrieved requirement text, without inventing answers. - Contract-Validated Output: Returns JSON matching a strict output contract (status, clarification_questions, citations, tool_calls, tokens) that the LangGraph orchestrator validates before handoff. - Lakehouse Artifact Persistence: Writes validated_requirement.json to Unity Catalog Volumes and upserts trace rows into state.artifacts and state.agent_runs for audit. - Use Case: A Jira ticket enters the pipeline via Agent 1; this agent validates the requirement package, finds the acceptance criteria are missing, and returns status needs_clarification with three specific questions, pausing the pipeline at the human approval gate. ## Quick Start Ask the agent to validate the requirement package for ticket PROJ-123 from the upstream artifacts volume and return the validated requirement JSON with any clarification questions.

Frequently Asked Questions about sdlc-agent-02-requirement-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate software requirements automatically in a Databricks pipeline?

Use this agent to check requirement packages for clear objectives, scope, and acceptance criteria. It calls the Databricks Foundation Model API, detects ambiguity and gaps, and returns a pass, fail, or needs_clarification verdict as validated JSON.

What is the output format of the requirement validation agent?

The agent returns JSON matching a strict output contract with fields for status, artifact_path, summary, clarification_questions, citations, tool_calls, tokens, and duration. The LangGraph orchestrator validates this schema before handing off to the next agent.

Can I call Genie Code from a Databricks agent via API?

No, Genie Code is UI-only with no public REST or SDK endpoint for headless invocation. Use the Foundation Model API on Model Serving for code and document generation, or the Genie Agents Conversation API for natural-language data questions.

What happens when requirement validation fails the contract check?

The agent gets one repair retry with the validation error appended to its context. If it still fails, the run is routed to the state.needs_human table so the approval-gate reviewers can intervene.

Where does the requirement validation agent store its artifacts?

Artifacts are written to /Volumes/{catalog}/state/artifacts/{ticket}/02_requirement-validation-agent/ in Unity Catalog. The agent also upserts rows into state.artifacts and state.agent_runs with the full prompt, tool calls, tokens, and latency for audit.