Files

brogeby c48b6e9c94 docs: scaffold agent instruction tree

Add AGENTS.md, CLAUDE.md, and the agents-docs/ tree (workflow, lessons,
engineering standards, context map, ADR seed, feature template) plus a
domain-bearing CONTEXT.md for each of the six subdomains: toju-app,
electron, server, e2e, website, docs-site.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-20 00:02:02 +02:00

2.2 KiB

Raw Blame History

Marketing Site (website)

Owns the public-facing Angular 19 marketing site — landing pages, screenshots, feature highlights, and download links pointing to release artifacts. Independent from the product runtime: shares no code or wire schemas with toju-app, electron, or the signaling server.

Format reference:

Vocabulary — bold term, one-sentence definition, aliases to avoid.

Relationships — bullets with bold terms and cardinality.

Boundaries / IO — what this subdomain exposes and consumes.

Invariants — rules that always hold.

Flagged ambiguities — terms in dispute with proposed resolutions.

See agents-docs/AGENTS_CONTEXT.md for the contract. Update in the same turn a trigger fires (see agents-docs/AGENT_WORKFLOW.md § CONTEXT.md upkeep).

Vocabulary

Term	Definition	Aliases to avoid
Marketing site	The Angular 19 app under `website/`, served separately from the product client.	"landing page" (it has multiple pages)
Release manifest	The release-metadata JSON the marketing site links to for download buttons; produced by `tools/generate-release-manifest.js` and published by Gitea Workflows.	"version manifest"

Relationships

The Marketing site links to release artifacts produced by the Gitea Workflows under .gitea/workflows/release-draft.yml and publish-draft-release.yml.
It does not consume the signaling server, the product client, or shared kernel types — independent codebase.

Boundaries / IO

Exposes: the public website bundle, deployed by .gitea/workflows/deploy-web-apps.yml.
Consumes: the release manifest URL and download links; static assets under website/src/images/.

Invariants

The marketing site has its own package.json and its own Angular version — do not hoist its dependencies into the root workspace.
It must remain functional with no backend (static deploy); any dynamic behavior should fail gracefully.

Flagged ambiguities

None recorded yet.

Agent-procedural rules (TDD, lint) live in /AGENTS.md. This file is the bounded-context domain artefact for the marketing site.

2.2 KiB Raw Blame History