docs: Refactor agent workflows and update AGENTS.md

[mlarsen-source]

Summary

Renames all 10 agent workflow files to shorter hyphenated names, standardizes each with a consistent Purpose / Preparation / Output / Constraints structure, and restructures AGENTS.md with a project description, promoted Development commands section, and 13 named Architecture Constraints subsections. A new docs/workflow-authoring.md documents the authoring standards and four authoritative references (AGENTS.md spec, MCP 2025-11-25, Claude Agent Skills overview and best practices) so future workflow additions follow the same conventions.

Documents changed

Scope	Change	What's different
10 workflow files	Rename + restructure	Shorter names (branch-audit.md, code-review.md, etc.); Purpose / Preparation / Output / Constraints sections; cross-references updated throughout
run-project.md	Restructure only	Added Purpose, Preparation, Constraints, and Output sections; title shortened
AGENTS.md	Restructure	Added project description; Development commands promoted to first section; Hard rules numbered list expanded into 13 named ### Architecture Constraints subsections; updated Workflow Library table and added ### Invocation examples
docs/agent-workflows/README.md	Update	New filenames in workflow table and all invocation examples; workflow-authoring.md pointer added
docs/workflow-authoring.md	New file	Standards table, AAIF governance note, four authoritative reference subsections, conventions template with key rules

File-by-file changes

Agent workflows — renamed and restructured

• docs/agent-workflows/branch-change-impact-audit.md → docs/agent-workflows/branch-audit.md: Renamed to a shorter name and added ## Preparation section; cross-references to old filenames updated to flag-review.md and code-review.md.
• docs/agent-workflows/code-quality-review.md → docs/agent-workflows/code-review.md: Renamed; ## Before review → ## Preparation, ## Required output format → ## Output; CSS review cross-reference updated to css-review.md.
• docs/agent-workflows/css-and-component-standards-review.md → docs/agent-workflows/css-review.md: Renamed; ## Before review → ## Preparation, ## Review scope → ## Scope, ## Required output format → ## Output; code-review.md cross-reference updated.
• docs/agent-workflows/feature-implementation-planning.md → docs/agent-workflows/feature-plan.md: Renamed; ## Before planning → ## Preparation with AGENTS.md read step prepended; added ## Output describing the 7-item plan format and ## Constraints replacing the prior ## Usage section.
• docs/agent-workflows/feature-flag-gating-review.md → docs/agent-workflows/flag-review.md: Renamed; added ## Preparation; ## Review scope → ## Scope, ## Required output format → ## Output; code-review.md cross-reference updated.
• docs/agent-workflows/figma-design-to-code.md → docs/agent-workflows/figma-to-code.md: Renamed; ## Access and ## Getting a node ID sections consolidated into new ## Preparation; ## Output format → ## Output; new ## Constraints section added; css-review.md cross-references updated.
• docs/agent-workflows/pre-merge-full-review.md → docs/agent-workflows/merge-review.md: Renamed; ## Before starting → ## Preparation; all 10 sub-workflow cross-references updated to new filenames across phase headings and phase execution steps.
• docs/agent-workflows/pull-request-description-generator.md → docs/agent-workflows/pr-description.md: Renamed; added ## Preparation pointing to the Context isolation and Inputs sections; ## Strict rules → ## Constraints, ## Required output format → ## Output.
• docs/agent-workflows/manual-qa-checklist-generator.md → docs/agent-workflows/qa-checklist.md: Renamed; added ## Preparation with AGENTS.md read and git diff steps; ## Required output format → ## Output; test-review.md cross-reference updated.
• docs/agent-workflows/test-suite-quality-review.md → docs/agent-workflows/test-review.md: Renamed; added ## Preparation; ## Required output format → ## Output; ## Final instruction merged into ## Constraints as a final bullet.

Agent workflows — restructured only

• docs/agent-workflows/run-project.md: Added ## Purpose, ## Preparation, ## Constraints, and ## Output sections; title shortened from "Run Project Workflow" to "Run Project"; trigger phrases moved into ## Preparation.

Top-level agent documentation

• AGENTS.md: Added 2-sentence project description after the title; moved ## Development commands to be the first substantive section; replaced the 11-item ### Hard rules numbered list with ## Architecture Constraints containing 13 named ### subsections (including forward-looking auth and database security constraints); merged the two duplicate "Running the project" headings into one; updated Workflow Library table with all new filenames; added ### Invocation subsection with 11 example strings; added workflow-authoring.md pointer in the Maintaining section.
• docs/agent-workflows/README.md: Updated workflow table and all invocation examples to new filenames; added workflow-authoring.md maintenance pointer; updated the general-pattern example.
• docs/workflow-authoring.md: New file establishing authoring standards — standards table covering AGENTS.md spec, MCP 2025-11-25, and Claude Agent Skills; AAIF governance paragraph; four authoritative reference subsections with URLs and annotations; conventions template with required section order and key rules.