Skip to content

AGENTS.md — Digital Products

This is the AI operating contract for the Digital Products venture (working name; public brand not finalized). It governs any AI agent — and any human following an agent-style workflow — doing substantive work anywhere under ventures/digital-products/.

1. Read the root contract first

Before reading anything in this file, you must have already read and be operating under the root AGENTS.md. This document only adds venture-specific requirements. It never replaces, weakens, or overrides anything in the root contract or in company-level docs/governance/, docs/standards/, or docs/architecture/. If anything here appears to conflict with a company-level document, the company-level document wins and the conflict should be flagged, not silently resolved in this venture's favor.

2. Required reading before doing product work

Before writing, editing, or reviewing anything that touches a Digital Products product, load, in order:

  1. Digital Products product philosophy — docs/strategy/product-philosophy.md
  2. Digital Products workbook standards — docs/standards/workbook-architecture-standard.md and its siblings in docs/standards/ (navigation/UX, visual design, data modeling, input/validation, calculation/formula, dashboard/reporting, configuration, compatibility, protection/security, accessibility, documentation/packaging, marketplace listing)
  3. Component catalog — components/component-catalog.md
  4. The product specification for the specific product being worked on — products/<slug>/ (product brief, data dictionary, calculation specification, test plan, tab specifications, decisions)
  5. The product's data dictionary (within products/<slug>/)
  6. The product's calculation specification (within products/<slug>/)
  7. The product's test plan (within products/<slug>/)
  8. Applicable financial guardrails, when the product touches personal or business finance — docs/standards/financial-product-guardrails.md

Do not skip steps because a task looks small. A one-cell formula change in a financial product still falls under the calculation and financial-guardrail standards.

3. This venture cannot weaken company-level requirements

Nothing authored in ventures/digital-products/ may lower, exempt, or reinterpret a company-wide requirement (security, privacy, customer trust, governance, or artifact lifecycle rules defined at the repository root). Venture-specific standards in this directory are additive — they exist to be more specific and often stricter than the company baseline, never looser.

4. Scope of this venture's conventions

Digital Products' conventions — its workbook design system, visual style, tab architecture, commercialization model, marketplace-listing practices, and similar venture-specific choices — apply only to this venture. They do not automatically apply to Shelfery or to any future venture. An agent working in another venture should not assume anything documented here is a company default; conversely, an agent working here should not import another venture's conventions without an explicit decision recorded in docs/decisions/.

5. Working norms

  • Treat all backlog and market claims as hypotheses unless a source is cited. See docs/ai/guardrails.md.
  • Route work to the correct agent role per docs/ai/role-routing.md, which maps onto the company-wide role definitions in ../../docs/ai/agent-role-definitions.md.
  • No document in this venture may be marked status: approved by an AI agent. Leave status as draft or proposed and let a human owner change it.
  • Do not touch products/_template/, components/, or prompts/ as part of documentation work assigned to this directory tree unless a task explicitly says to.

Report an issue about this page