Tempo-driven HELIX and documentor corrections
Example from HELIX’s own docs. This generated page comes from
docs/helix/. Use it to see the method in practice; start with the artifact-type catalog for reusable templates. Historical plans and reports may describe retired architecture.
Source identity (from
02-design/plan-tempo-documentor-gaps.md):
ddx:
id: plan-tempo-documentor-gaps
authoring:
home: repoTempo-driven HELIX and documentor corrections
Scope and decisions
The operator authorized triage and implementation of seven adoption gaps. Tempo is read-only reference material; do not edit it. Preserve the existing uncommitted HELIX schema/publication work and compose with it.
- Extend scaffold section linking to Hextra menu entries and home cards after generated content exists. Preserve existing entries, require a real output directory, and make repeated linking byte-stable.
- Add upstream UMF TableSpec 1.0 detection, deterministic columns/keys/FK reference and entity graph, and automatic discovery into the existing UMF schema browser publisher. Keep tablespec pipeline detection separate; when both traits are selected, its guidebook occupies data/pipeline-tables while UMF owns data/tables. Do not duplicate the browser implementation.
- Init proposes reviewable design-stage skips when HELIX docs exist without application source, and operational data mode when UMF tables have no pipeline signal. Operational overview uses data-design, not analytics data-architecture. Existing publish configuration remains operator authority. Missing-artifact reports intentionally show affected page keys beside artifact types.
- Ship a separate Pages deployment workflow and update the check/refresh pin to v0.19.1. Tempo run 40952714352 successfully built and deployed; the new template also passes the deployment base URL to Hugo and scopes deployment permissions. Repository-specific locked dependency installs remain adoption configuration.
- Genesis and Frame seed applicable software quality defaults, distinguish future software from permanently source-free work, allow reasoned pruning, and preserve the existing mandatory source-code evidence floor.
- Document complete project-owned concern/practice files and slot overrides for Azure/Entra rather than shipping unverified provider-specific practices.
- Data Design references authoritative per-table UMF YAML, the upstream browser, relationship checks and a publication step. Keep rationale in prose and exact schema structure in YAML; browser rendering does not prove schema validity.
Verification and completion
Run documentor Python regressions (section linking, UMF detection/generation/
publication discovery/coexistence, profile boundaries), the complete documentor
suite, skill/catalog checks and just test; inspect diff whitespace. Record any
failed gate with its exact cause, keeping unrelated checkout changes intact.
Do not publish a release or edit Tempo. A later release is needed before Tempo
can consume the changes using a pinned tag.
Completion evidence
- Full documentor suite passed, including all shell regressions, 81 Python tests (eight new Tempo-gap regressions), wheel build and isolated installation.
- HELIX
just testpassed; its InnSigle gate reported a skip because the CLI could not resolve through the restricted npm environment. Architecture tour rendering also reported its existing optional skip without Chromium. - Skill validation, packaged documentor catalog parity, generated reference refresh and diff whitespace checks passed.
- Tempo’s existing Pages build and deployment succeeded in GitHub Actions run 40952714352. The catalog adaptation has local structural coverage; no new workflow run was triggered and no Tempo files were changed.
- Upstream schema/browser infrastructure was committed independently as
24a6e12bwhile this work was in progress. This change extends that commit; it does not replace its schema publisher or include its unrelated edits. - Remaining adoption: release these fixes, update Tempo’s pinned tool version, remove corresponding workarounds there, and run Tempo’s per-type Frame/Design validation. Those Tempo edits and a release are outside this change.
Innsigle seal: model-primary by HELIX
The signature covers the markdown source of this page, not these HTML bytes. This page quotes that seal; verify it against the source file.
- Composition
- model-primary
- Issuer
- HELIX
helix - Signing key
ed25519:b0865d76d834a52c48506414d16f4e5a(build key)- Signed source
artifacts/plan-tempo-documentor-gaps.md- Signed
- 2026-11-16T15:52:45Z
- Content digest
sha256:fa3a7471…73fd6838
This build key is endorsed by the human key for build signing; the signature is not a detector and not a truth guarantee.
Raw attestation JSON
{
"payload": {
"innsigle": "1",
"type": "https://innsigle.dev/claim/colophon/v1",
"issued_at": "2026-11-16T15:52:45Z",
"issuer": {
"id": "helix",
"name": "HELIX",
"key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
"key_url": "https://documentdrivendx.github.io/helix/.well-known/innsigle/keys.json"
},
"subjects": [
{
"uri": "https://documentdrivendx.github.io/helix/artifacts/plan-tempo-documentor-gaps/",
"digest": {
"alg": "sha256",
"value": "fa3a747171e307cb58001bca390d984d400ce5c4e66b8ef21e541a1d73fd6838"
}
}
],
"colophon": {
"schema_version": "1",
"composition": "model-primary",
"ingredients": [
{
"kind": "model",
"name": "Claude",
"role": "draft"
},
{
"kind": "tool",
"name": "sloptimizer",
"role": "rewrite"
},
{
"kind": "human",
"name": "operator",
"role": "structure-edit"
}
],
"notes": null
}
},
"payload_encoding": "json",
"signatures": [
{
"key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
"alg": "ed25519",
"sig": "vC7sixNm114_tLdKA9YPdFnaF7ksH3oRAa9og_qn8DCQ3USsSWegXFsJ6rf2NpZpQ5kVY01Qgzl_YMtZ58bmBw",
"signed_at": "2026-11-16T15:52:45Z"
}
]
}