chore: add UX infrastructure (quickstart, doctor, setup)

Added by ux-rollout.jl batch script.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: hyperpolymath

QUICKSTART-DEV.adoc

@@ -0,0 +1,39 @@
+= Formatrix Docs — Developer Quickstart
+:toc: preamble
+
+Clone, build, test, contribute.
+
+== Prerequisites
+
+* Git 2.40+
+* just (command runner)
+* See `just doctor` output for language-specific requirements
+
+== Setup
+
+[source,bash]
+----
+git clone https://github.com/hyperpolymath/formatrix-docs
+cd formatrix-docs
+just doctor    # verify toolchain
+just heal      # auto-install missing tools
+----
+
+== Development Workflow
+
+[source,bash]
+----
+just tour      # understand the codebase
+just help-me   # see available commands
+----
+
+== Before Committing
+
+[source,bash]
+----
+just assail    # run panic-attacker security scan
+----
+
+== Contributing
+
+See link:CONTRIBUTING.md[CONTRIBUTING.md] for guidelines.

QUICKSTART-MAINTAINER.adoc

@@ -0,0 +1,40 @@
+= Formatrix Docs — Maintainer Quickstart
+:toc: preamble
+
+Packaging, deployment, and release management.
+
+== Prerequisites
+
+* Git 2.40+
+* just (command runner)
+* Familiarity with the project (run `just tour` first)
+
+== CI/CD
+
+This project uses GitHub Actions. Workflows are in `.github/workflows/`.
+
+Key workflows:
+
+* `hypatia-scan.yml` — Neurosymbolic security scanning
+* `codeql.yml` — Code analysis
+* `scorecard.yml` — OpenSSF Scorecard
+* `mirror.yml` — GitLab/Bitbucket mirroring
+
+== Releasing
+
+1. Update version in project config
+2. Update CHANGELOG.md
+3. Tag: `git tag -s v<VERSION>`
+4. Push: `git push origin main --tags`
+
+== Container Build (if applicable)
+
+[source,bash]
+----
+podman build -f Containerfile -t formatrix-docs:latest .
+----
+
+== Mirrors
+
+This repo is mirrored to GitLab and Bitbucket (hyperpolymath accounts)
+via the `mirror.yml` workflow.

QUICKSTART-USER.adoc

@@ -0,0 +1,33 @@
+= Formatrix Docs — User Quickstart
+:toc: preamble
+
+Get up and running in 60 seconds.
+
+== Prerequisites
+
+* Git 2.40+
+* just (command runner) — https://just.systems
+
+== Install
+
+[source,bash]
+----
+git clone https://github.com/hyperpolymath/formatrix-docs
+cd formatrix-docs
+just doctor    # check toolchain
+just heal      # auto-install missing tools
+----
+
+== First Run
+
+[source,bash]
+----
+just tour      # guided project tour
+just help-me   # see common workflows
+----
+
+== Get Help
+
+* `just help-me` — common workflows
+* `just doctor` — diagnose toolchain issues
+* https://github.com/hyperpolymath/formatrix-docs/issues — report bugs

contractiles/intend/Intentfile.a2ml

@@ -0,0 +1,22 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Intentfile (A2ML Canonical)
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath)
+
+@abstract:
+Declared intent and purpose for Formatrix Docs.
+@end
+
+## Purpose
+
+Formatrix Docs — // SPDX-License-Identifier: MPL-2.0-or-later
+
+## Anti-Purpose
+
+This project is NOT:
+- A fork or wrapper around another tool
+- A monorepo (unless explicitly structured as one)
+
+## If In Doubt
+
+If you are unsure whether a change is in scope, ask.
+Sensitive areas: ABI definitions, license headers, CI workflows.

contractiles/trust/Trustfile.a2ml

@@ -0,0 +1,25 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Trustfile (A2ML Canonical)
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath)
+
+@abstract:
+Trust and provenance verification for Formatrix Docs.
+Maximal trust by default — LLM may read, build, test, lint, format.
+@end
+
+@trust-level: maximal
+@trust-boundary: repo
+@trust-actions: [read, build, test, lint, format]
+@trust-deny: [delete-branch, force-push, modify-ci-secrets, publish]
+
+## Integrity
+
+### license-content
+- description: LICENSE contains expected SPDX identifier
+- run: grep -q 'SPDX\|License\|MIT\|Apache\|PMPL\|MPL' LICENSE
+- severity: critical
+
+### no-secrets-committed
+- description: No .env or credential files in repo
+- run: test ! -f .env && test ! -f credentials.json && test ! -f .env.local
+- severity: critical

setup.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath)
+#
+# Formatrix Docs — Universal Setup Script
+# Detects platform and shell, installs just, then hands off to Justfile.
+
+set -euo pipefail
+
+echo "═══════════════════════════════════════════════════"
+echo "  Formatrix Docs — Setup"
+echo "═══════════════════════════════════════════════════"
+echo ""
+
+# Platform detection
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+echo "Platform: $OS $ARCH"
+
+# Shell detection
+CURRENT_SHELL="$(basename "$SHELL" 2>/dev/null || echo "unknown")"
+echo "Shell: $CURRENT_SHELL"
+echo ""
+
+# Check for just
+if ! command -v just >/dev/null 2>&1; then
+    echo "just (command runner) is required but not installed."
+    echo ""
+    case "$OS" in
+        Linux)
+            if command -v cargo >/dev/null 2>&1; then
+                echo "Installing just via cargo..."
+                cargo install just
+            elif command -v brew >/dev/null 2>&1; then
+                echo "Installing just via Homebrew..."
+                brew install just
+            else
+                echo "Install just from: https://just.systems/man/en/installation.html"
+                exit 1
+            fi
+            ;;
+        Darwin)
+            if command -v brew >/dev/null 2>&1; then
+                echo "Installing just via Homebrew..."
+                brew install just
+            else
+                echo "Install Homebrew first: https://brew.sh"
+                echo "Then: brew install just"
+                exit 1
+            fi
+            ;;
+        *)
+            echo "Install just from: https://just.systems/man/en/installation.html"
+            exit 1
+            ;;
+    esac
+    echo ""
+fi
+
+echo "Running diagnostics..."
+just doctor
+
+echo ""
+echo "Setup complete. Run 'just help-me' for common workflows."