Skip to content

chore: suppress ARC-004 (API Contracts) — N/A for markdown plugin #13

@zircote

Description

@zircote

Quality Gate Reference

  • Checklist Item: ARC-004 (API Contract Design)
  • Current Score: 0.35/1.0
  • Impact: High — blocks Tier 1 floor (0.5 minimum)
  • Effort: Low

Description

ARC-004 checks for formal API contracts (OpenAPI, JSON Schema, Protocol Buffers). This Claude Code plugin's interface is markdown files (agents/.md, skills//SKILL.md) consumed by Claude Code's runtime — not HTTP endpoints or programmatic interfaces.

The correct action is a documented suppression: "Plugin interface is defined by markdown file conventions per Claude Code plugin spec; no programmatic API surface exists that would benefit from OpenAPI/JSON Schema contracts."

Optionally, add a PLUGIN-SPEC.md documenting the expected markdown structure as a lightweight contract.

Acceptance Criteria

  • ARC-004 suppressed in .cogitations/config.yaml with justification
  • Tier 1 floor no longer blocked by ARC-004
  • Optional: PLUGIN-SPEC.md documenting markdown file conventions

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions