Skip to content

Commit ba0f16b

Browse files
hyperpolymathclaude
andcommitted
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>
1 parent a301800 commit ba0f16b

3 files changed

Lines changed: 74 additions & 0 deletions

File tree

EXPLAINME.adoc

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
= Standards — EXPLAINME
2+
:toc: preamble
3+
4+
This document backs up the claims made in README with evidence and rationale.
5+
6+
== What Is This?
7+
8+
Standards is a hyperpolymath project. See README.adoc for usage.
9+
10+
== Why These Choices?
11+
12+
=== Language
13+
14+
The language(s) used in this project were chosen per the hyperpolymath
15+
language policy (see CLAUDE.md for the full list of allowed/banned languages).
16+
17+
=== Architecture
18+
19+
Architecture decisions are documented in `.machine_readable/` checkpoint files.
20+
21+
== Alternatives Considered
22+
23+
(To be filled in as the project matures.)
24+
25+
== Proof of Claims
26+
27+
(Link formal verification results from the `proven` repo where applicable.)
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Intentfile (A2ML Canonical)
3+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath)
4+
5+
@abstract:
6+
Declared intent and purpose for Standards.
7+
@end
8+
9+
## Purpose
10+
11+
Standards — Organization-wide standards, specifications, and governance templates for the Hyperpolymath ecosystem.
12+
13+
## Anti-Purpose
14+
15+
This project is NOT:
16+
- A fork or wrapper around another tool
17+
- A monorepo (unless explicitly structured as one)
18+
19+
## If In Doubt
20+
21+
If you are unsure whether a change is in scope, ask.
22+
Sensitive areas: ABI definitions, license headers, CI workflows.

contractiles/trust/Trustfile.a2ml

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# SPDX-License-Identifier: PMPL-1.0-or-later
2+
# Trustfile (A2ML Canonical)
3+
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath)
4+
5+
@abstract:
6+
Trust and provenance verification for Standards.
7+
Maximal trust by default — LLM may read, build, test, lint, format.
8+
@end
9+
10+
@trust-level: maximal
11+
@trust-boundary: repo
12+
@trust-actions: [read, build, test, lint, format]
13+
@trust-deny: [delete-branch, force-push, modify-ci-secrets, publish]
14+
15+
## Integrity
16+
17+
### license-content
18+
- description: LICENSE contains expected SPDX identifier
19+
- run: grep -q 'SPDX\|License\|MIT\|Apache\|PMPL\|MPL' LICENSE
20+
- severity: critical
21+
22+
### no-secrets-committed
23+
- description: No .env or credential files in repo
24+
- run: test ! -f .env && test ! -f credentials.json && test ! -f .env.local
25+
- severity: critical

0 commit comments

Comments
 (0)