f909ab2a8d
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.
1.1 KiB
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