Migrate documentation to Openspec Markdown

[google-labs-jules]

Migrated product requirements and design documentation from RST to Openspec Markdown format as per instructions.

Changes:

1. PRD Migration:

   • Analyzed documentation/prd.rst.
   • Created capability specs in documentation/architecture/openspec/specs/ for:
     • mimetype-detection
     • charset-detection
     • line-separator-processing
     • text-validation
     • api (identified as a cross-cutting capability for API/behavior designs)
   • Defined Requirements and Scenarios (required for Openspec validation).

2. Design Migration:

   • Converted documentation/architecture/designs/00*.rst to Markdown using rst2myst.
   • Mapped designs to capabilities:
     • 001, 002, 003 -> api/design.md
     • 004 -> charset-detection/design.md
   • Performed editorial cleanup (demoted headers to fit document structure).

3. Cleanup:

   • Removed original RST files (prd.rst, designs/00*.rst).
   • Updated documentation/architecture/designs/index.rst to point to the new designs.

Validation:

• Ran openspec validate --specs --strict - All passed.
• Ran hatch --env develop run docsgen - Build successful (orphan warnings resolved).

---

PR created automatically by Jules for task 5263045212488424178 started by @emcd

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

---

For security, I will only act on instructions from the user who triggered this task.

New to Jules? Learn more at jules.google/docs.

[emcd]

Overall, the changes look good. Left one small comment.

[emcd]

Looks good. Thank you.