Resource Summary

Purpose

A resource summary is a local, durable note for an external source. Its unique job is to capture what we learned from the source and how HELIX uses it, so artifact prompts can cite the local resource library instead of scattering raw external links through the artifact catalog.

Quality checklist from the prompt

Source URL is present
Summary opens with a one-sentence definition other artifacts can reuse
Summary is accurate and concise
Relevant findings are specific enough to reuse
HELIX usage names the artifact, concern, or decision it supports
Authority boundary is explicit
External links live in the resource summary, not scattered through artifact prompts

Example

Show a worked example of this artifact

---
ddx:
  id: example.resource-summary.product-vision-board
  authoring:
    home: repo
---

# Product Vision Board

## Source

- URL: https://www.romanpichler.com/tools/product-vision-board/
- Accessed: 2026-05-12

## Summary

Roman Pichler's Product Vision Board is a product strategy tool for describing,
visualizing, and validating product vision and strategy. It captures target
group, needs, product direction, and business goals; the extended version adds
business model elements such as competitors, revenue sources, costs, and
channels.

## Relevant Findings

- A vision artifact should name the target group and needs, not only the
  product idea.
- Product direction and business goals belong together at the strategy level.
- Business model detail can be useful, but it should not crowd out the core
  vision.

## HELIX Usage

This resource informs the Product Vision artifact. HELIX uses the same
strategic ingredients while keeping market sizing and investment rationale in
the Business Case.

## Authority Boundary

This resource does not define requirements, competitive analysis, or
implementation plans. Those belong in the PRD, Competitive Analysis, and Design
artifacts.

Reference

Activity	Discover — Validate that an opportunity is worth pursuing before committing to a development cycle.
Default location	`docs/resources/[resource-slug].md`
Requires	None
Enables	None
Informs	Product Vision PR-FAQ Principles Concerns
Generation prompt	Show the full generation prompt # Resource Summary Generation Prompt Create a concise summary of one external resource that HELIX uses to ground an artifact, concern, decision, or public explanation. ## Storage Location Store at: `docs/resources/[resource-slug].md` ## Purpose A resource summary is a local, durable note for an external source. Its unique job is to capture what we learned from the source and how HELIX uses it, so artifact prompts can cite the local resource library instead of scattering raw external links through the artifact catalog. ## Template Adherence Use the sections in `template.md`. Do not add sections unless the source needs a short note about access limitations. ## What To Capture - The canonical URL and access date; for a standard, the owner, licence, and the release or revision read. - A short neutral summary of the source, opening with the one-sentence definition other artifacts reuse when they name the source on first use. - Where the project derives a vocabulary, code set, or identifier list from the source: the file, branch, or code set it comes from and the tool that resolves it, so a reader can regenerate it. - The specific findings HELIX will reuse. - The artifact, concern, or decision the resource informs. - The boundary: what this source does not decide. ## What To Avoid - Do not copy long passages from the source. - Do not summarize the whole source when HELIX only uses one idea. - Do not turn the note into requirements, design, or implementation guidance. - Do not cite the source as authority beyond the point HELIX actually uses. - Do not transcribe labels, codes, or identifiers from memory of the source; point at the file and the tooling that reads it. ## Quality Checklist - [ ] Source URL is present - [ ] Summary opens with a one-sentence definition other artifacts can reuse - [ ] Summary is accurate and concise - [ ] Relevant findings are specific enough to reuse - [ ] HELIX usage names the artifact, concern, or decision it supports - [ ] Authority boundary is explicit - [ ] External links live in the resource summary, not scattered through artifact prompts
Template	Show the template structure --- ddx: id: resource-summary authoring: home: repo --- # [Resource Title] ## Source - URL: [Canonical URL] - Accessed: [YYYY-MM-DD] ## Summary [Two to four sentences summarizing what the source contributes to HELIX.] ## Relevant Findings - [Finding HELIX will reuse] - [Finding HELIX will reuse] - [Finding HELIX will reuse] ## HELIX Usage [Name the artifact, concern, decision, or public page this resource informs and explain how it should be used.] ## Authority Boundary [Explain what this source does not govern. Name the HELIX artifact that owns the next level of detail when relevant.] ## Review Checklist - [ ] Source URL and access date are present - [ ] Summary is concise and source-faithful - [ ] Findings are relevant to HELIX - [ ] HELIX usage is specific - [ ] Boundary prevents over-applying the source

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: artifact-types/discover/resource-summary.md
Signed: 2026-09-23T14:11:58Z
Content digest: sha256:8410cd38…a7120c55

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/artifact-types/discover/resource-summary/",
        "digest": {
          "alg": "sha256",
          "value": "8410cd38f697ffcf0aa482c5fd7e17716f424fb679c00fe275865cb8a7120c55"
        }
      }
    ],
    "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": "SWBgxA026qkSFtDbaWamanrcdIGVxcX341TYo2Jsl7wtat9HKCdCf8w23t0YlwYDadYIMalpoAIk1r8fANsFBg",
      "signed_at": "2026-09-23T14:11:58Z"
    }
  ]
}

attestation file · issuer keys