Files
c0py/AGENTS.md
T
admin f909ab2a8d
Deploy to Coolify / deploy (push) Failing after 1s
CI (SIAX Cloud) / security (push) Successful in 16s
CI (SIAX Cloud) / contracts (push) Successful in 24s
CI (SIAX Cloud) / quality (push) Successful in 52s
docs: add Digital Twin Specification for website analysis and reproduction
Adds comprehensive specification document at docs/spec/DIGITAL-TWIN-SPEC.md covering:

- Taxonomy of all website components (design, layout, UI components, pages,
  functionality, data, infrastructure, i18n)
- Ontology: entity types, attributes, relationships
- Topology: DOM, CSS spatial, visual hierarchy, responsive breakpoints
- Media capture: images, video, icons, fonts, documents
- Data collection: text, structured data, URLs, metadata
- Functional specification: behavior, state machines, API contracts
- Design system discovery and analysis
- AI agent architecture (4 phases: Discovery, Analysis, Synthesis, Verification)
- Quality criteria (completeness, accuracy, machine-readability)
- Output format and file structure (c0py-output/ schema)
- Agent contracts, parallelization, error handling

Also updates AGENTS.md and README.md to reference the spec.

Covers 14 major sections with detailed subsections for each component
category found on any modern website or product.

Co-commit with c0py repo on Gitea.
2026-09-16 13:42:52 +02:00

1.1 KiB

C0PY — AGENTS.md

Repo-konventioner

  • Package manager: pnpm (frozen-lockfile)
  • Framework: Next.js (apps/web), Fastify (apps/api)
  • TypeScript: strict mode, bundler module resolution
  • CI: Gitea Actions — .gitea/workflows/ci.yml
  • Deploy: Coolify via .gitea/workflows/deploy.yml
  • Secrets: Infisical (vault.siax.io) — ALDRIG i repo
  • Testing: vitest (apps/api, packages/*)
  • Lint: eslint flat config
  • Testing: vitest (apps/api, packages/*)
  • OTel: not yet wired — add bootstrap at apps/api/src/index.ts entry when available
  • Tenant: bound to session via CL0UD, NEVER from client input

Kontrakt

  • API-kontrakt: contracts/openapi.yaml
  • Schema-versionshantering: semantisk versionering i packages/types
  • Digital Twin Spec: docs/spec/DIGITAL-TWIN-SPEC.md (fullständig specifikation för webbplats-analys och identisk reproduktion)

Fällor

  • NEXT_PUBLIC_* ska ALDRI innehålla hemligheter
  • Alla writes till AUD0/ST0RE via klientskikt, aldrig direkt
  • Crawling ska vara throttle-ad och respect robots.txt