[adamjohnwright]

The first step of #4. It sets up Spec Kit so the exporter's work is specified before it is built, as in reactome/WebsiteAngular.

Contents:

• Spec Kit 1.0.4, set up the way WebsiteAngular has it: the Claude integration, shell scripts and sequential feature numbers.
  • .specify/ holds the templates and scripts.
  • .claude/skills/ holds the /speckit-* commands.
• A constitution (.specify/memory/constitution.md). Each principle names what breaking it has already cost this exporter:
  • output is proven against the release's published biopax.zip, by meaning;
  • the validator's reports are read, not its exit code (it always exits 0);
  • tests are seen failing before they are trusted;
  • one library serves both the release and the website;
  • no use of Reactome's production services;
  • people's names stay out of the repository.
• CLAUDE.md: day-to-day guidance. Use Spec Kit for feature-sized work, how to prove what is written, and what to check before pushing.

No code changes.

Next: the first spec (specs/001-…), covering what #4 describes: the library and command-line split, today's content, the mode and xml:base fixes, the comparison with biopax.zip, and the validator in CI.

From an adversarial review, which ran the checks rather than reading them:

• mvn test compiles no tests. The Kotlin plugin binds only compile, so the 42 tests in src/test have never run.
• ktlint is not a gate. The Docker lint stage is never started by CI, and the build's ktlint:format rewrites the sources first. mvn ktlint:check on its own fails on main.
• The validator. validateBioPAXFile is never called.

The constitution and CLAUDE.md now say so: the gates are what the first spec makes real, not checks to trust today. The rest of the review's points are corrected too:

• the coverage gap is described as read from the code, not measured from output;
• Principle IV is phrased as the target, not as what exists;
• Principle V names the download directory as the one allowed source;
• CLAUDE.md gains "This repository is public".

🤖 Generated with Claude Code