claude-mcp-etsi: Instructions file for Claude Code

ETSI Standards Connector

Project Purpose

This project is a Claude-powered connector for ingesting, summarising, and making queryable ETSI telecommunications and media standards documents. The outputs are structured markdown summaries that can later be used to answer questions, validate outputs, generate conformant data (e.g. XML), or write conformant code.

Architecture Overview

etsi.org (PDF) --> fetch/parse --> summariser agent --> standards/*.md
                                                              ^
                                                              |
                                              query agent --> answers / code / XML

Key directories:

• standards/ — generated summary files, one per standard (e.g. standards/TS-103-720.md)
• prompts/ — reusable prompt templates for summarisation and querying
• src/ — connector source code (fetcher, parser, summariser, query interface)
• cache/ — raw downloaded documents (PDFs, HTML); git-ignored

Standards Summary Format

Every file in standards/ MUST follow this structure:

# <Standard Number>: <Title>
**Version**: x.y.z  **Date**: YYYY-MM  **Status**: [Normative|Informative]
**Source**: <URL>

## Scope
One paragraph.

## Key Concepts
- **Term**: definition

## Normative References
| Standard | Title | Relevance |
|----------|-------|-----------|

## Data Structures
For each structure: name, fields (mandatory/optional), types, allowed values, recommended values.

For structures that are binary data: add the byte position and length. Values should preferably be given in hex. If the value is a simple binary flag, this should be 1 or 0.

## Rules and Constraints
Numbered list. Each entry MUST indicate [M] mandatory or [O] optional.
Where a choice of values exists, list all options and mark recommended with *.

## Workflows and Sequences
Numbered steps or sequence diagrams (Mermaid). Indicate mandatory/optional steps.

## Conformance Requirements
Summary of SHALL / SHOULD / MAY clauses from the standard.

## Related Standards
Standards referenced in this document that may warrant further retrieval.

## Summary Notes
Brief prose capturing anything not covered above.