Project Concerns

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.

Project Concerns

Active Concerns

hugo-hextra (microsite)
product-microsite-ia (microsite)
demo-asciinema (demo)
e2e-playwright (testing)

Area Labels

Label	Applies to
`all`	Every bead
`workflow`	workflows/actions, workflows/concerns, workflow engine
`docs`	docs/, plans, reports, and user-facing workflow documentation
`site`	website/, microsite content and deployment
`demo`	docs/demos/, demo scripts and recordings
`testing`	tests/, deterministic harnesses, and verification-only slices
`artifacts`	workflows/activities/*/artifacts metadata, prompts, and templates

Use combined labels when the work spans more than one concern surface. Examples:

area:workflow,area:docs for workflow-contract doc updates
area:site,area:testing for Playwright coverage on the microsite
area:workflow,area:artifacts for artifact-definition changes

Project Overrides

hugo-hextra

Theme version: Hextra v0.12.1 — pinned in website/go.mod
Hugo version: 0.159.2 extended — pinned in .github/workflows/pages.yml
Deployment: GitHub Pages at documentdrivendx.github.io/helix/
Custom shortcode: asciinema.html for terminal recording embeds

product-microsite-ia

Reader modes: evaluators, new users, active HELIX users, and contributors
Top-level sections: Why explains the thesis, Use gets a user productive, Types explains methodology objects, Reference provides exact lookup, and Artifacts exposes HELIX’s own governing documents
Artifact Types navigation: activity order is the primary ordering model; core artifacts are visible immediately within each activity; supporting artifacts stay in activity context with lighter treatment or inline disclosure
Navigation contract: left navigation shows site hierarchy and active location; right navigation shows headings for the current page only
Proof path: public examples, source artifacts, and deterministic checks must support product claims about shared memory and trustworthy context

demo-asciinema

Current demos: helix-quickstart (full lifecycle), helix-concerns (drift detection), helix-evolve (requirement threading), helix-experiment (metric-driven optimization)
Experimental demos: helix-interactive is kept in docs/demos/ for internal exploration and manual recording workflows; it is not part of the shipped public microsite or Pages recording inventory
Agent harness: scripts/demos/capture_session.py wraps claude -p --output-format=stream-json and writes the session record; the committed session.jsonl replays deterministically without an API key
Recording container: Ubuntu 24.04 with project-specific deps (Node.js or Bun)
Cast files: archived in docs/demos/*/recordings/ and copied to website/static/demos/

e2e-playwright

Test location: website/e2e/microsite.spec.ts
Config: website/playwright.config.ts with video on, trace on failure
Dev server: Hugo server on port 1313, started automatically by Playwright
Test data: site content files are the test data — all pages, shortcodes, and navigation patterns are exercised
Coverage: every page loads, every glossary sub-page verified, navigation workflows tested, screenshots for visual regression
Videos: generated for every test in website/test-results/

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/concerns.md
Signed: 2026-09-23T14:11:58Z
Content digest: sha256:4f0ea24c…3d0624e9

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-09-23T14:11:58Z",
    "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/concerns/",
        "digest": {
          "alg": "sha256",
          "value": "4f0ea24c598e57c123e6510e653a3fe1f781f775d1445b4505cc44033d0624e9"
        }
      }
    ],
    "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": "XnpnQ7tAWtVFAOLMX-26cdVm_wCvy4xIEMRbhfz_n6-dPH1LNMsLapWO4CGlHXp-7MKGvwPzw-9UAtXxuegsCQ",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}

attestation file · issuer keys