Implement parse tools (parse_plugin_interface, parse_claude_md_agents) #186

New Issue

lmiranda · 2026-01-26T19:02:10Z

lmiranda commented

2026-01-26 19:02:10 +00:00

Overview

Implement the parsing tools that extract structured data from documentation.

Tools

parse_plugin_interface

Input: Plugin path or README content
Output: Structured interface (inputs accepted, outputs produced, tool names)
Parse README.md for interface declarations
Extract tool categories, inputs/outputs, agents, commands

parse_claude_md_agents

Input: Claude.md path or content
Output: List of agents with their tool sequences
Parse agent definitions from Claude.md
Extract tool references and data flow

Implementation Notes

Use regex or markdown parser to extract structured sections
Handle variations in markdown formatting
Return normalized data structures for downstream validation

Sprint: Sprint 2 - contract-validator Plugin
Labels: Type/Feature, Complexity/Medium, Priority/High, Effort/M

## Overview Implement the parsing tools that extract structured data from documentation. ## Tools ### parse_plugin_interface - **Input:** Plugin path or README content - **Output:** Structured interface (inputs accepted, outputs produced, tool names) - Parse README.md for interface declarations - Extract tool categories, inputs/outputs, agents, commands ### parse_claude_md_agents - **Input:** Claude.md path or content - **Output:** List of agents with their tool sequences - Parse agent definitions from Claude.md - Extract tool references and data flow ## Implementation Notes - Use regex or markdown parser to extract structured sections - Handle variations in markdown formatting - Return normalized data structures for downstream validation **Sprint:** Sprint 2 - contract-validator Plugin **Labels:** Type/Feature, Complexity/Medium, Priority/High, Effort/M

lmiranda added this to the Sprint 2 - contract-validator Plugin milestone 2026-01-26 19:02:39 +00:00

lmiranda referenced this issue

2026-01-26 19:32:30 +00:00

Create contract-validator plugin structure #185

lmiranda commented

2026-01-26 19:41:22 +00:00

Implementation Complete

Branch: feat/186-parse-tools
Commit: 2b041cb

Tools Implemented

`parse_plugin_interface`

Extracts from README.md:

Plugin name and description
Commands (table format and ### headers)
Agents (table format)
Tools with categories
Features list

`parse_claude_md_agents`

Extracts from CLAUDE.md:

Agent definitions from Four-Agent Model tables
Personality and responsibilities
Tool references

Test Results

Plugin	Commands	Agents	Tools
projman	12	0	0
data-platform	7	2	32
pr-review	3	0	0
code-sentinel	1	0	0

CLAUDE.md: 4 agents (Planner, Orchestrator, Executor, Code Reviewer)

## Implementation Complete **Branch:** `feat/186-parse-tools` **Commit:** `2b041cb` ### Tools Implemented #### `parse_plugin_interface` Extracts from README.md: - Plugin name and description - Commands (table format and ### headers) - Agents (table format) - Tools with categories - Features list #### `parse_claude_md_agents` Extracts from CLAUDE.md: - Agent definitions from Four-Agent Model tables - Personality and responsibilities - Tool references ### Test Results | Plugin | Commands | Agents | Tools | |--------|----------|--------|-------| | projman | 12 | 0 | 0 | | data-platform | 7 | 2 | 32 | | pr-review | 3 | 0 | 0 | | code-sentinel | 1 | 0 | 0 | CLAUDE.md: 4 agents (Planner, Orchestrator, Executor, Code Reviewer)

lmiranda referenced this issue from a commit

2026-01-26 19:41:22 +00:00

feat(contract-validator): implement parse tools (#186)

lmiranda closed this issue

2026-01-26 19:41:28 +00:00

lmiranda referenced this issue

2026-01-26 20:22:18 +00:00

feat(contract-validator): Complete Sprint 2 - Contract Validator Plugin #195

Sign in to join this conversation.