cox-protocol-package 1.0.0

package/manifest.cox

@@ -0,0 +1,106 @@
+CoxVersion: "1.0"
+FileType: "manifest"
+Slug: "local_app_manager"
+Schema: "cox.manifest.v1"
+ProjectName: "LocalAppManager"
+PackageName: "cox_protocol_package_corrected.zip"
+ProtocolExtension: ".cox"
+MimeType: "application/vnd.cox+yaml"
+Encoding: "UTF-8"
+SyntaxBase: "YAML-compatible structured text"
+EntryPoint: "manifest.cox"
+ReferenceDocs:
+  - "README.md"
+  - "COX_FILE_FORMAT_SPECIFICATION_v1.0.md"
+  - "verification_report.txt"
+  - "zip_content_listing.txt"
+GuideDocs:
+  - "guides/imported-packages/cox_protocol_package_compiled.md"
+  - "guides/npm-installation.md"
+ProtocolDocs:
+  - "protocols/llm_agent_zip_recreation_instructions.cox"
+  - "protocols/deterministic_naming_convention.cox"
+  - "protocols/recursive_decomposition_protocol.cox"
+  - "protocols/screenshot_partitioning_protocol.cox"
+  - "protocols/evidence_and_uncertainty_protocol.cox"
+  - "protocols/sub_agents_orchestration.cox"
+  - "protocols/design_tokens.cox"
+  - "protocols/component_binding_graph.cox"
+  - "protocols/website_logic_and_functionality.cox"
+  - "protocols/coding_agent_starting_point.cox"
+  - "protocols/visual_acceptance_checklist.cox"
+SkillBundles:
+  - "skills/design-spec-writer"
+  - "skills/package-docs-writer"
+  - "skills/screenshot-semantic-namer"
+  - "skills/visual-token-extractor"
+  - "skills/zip-design-orchestrator"
+  - "skills/zip-packager"
+Schemas:
+  - "schemas/cox.manifest.v1.schema.json"
+  - "schemas/cox.page.v1.schema.json"
+  - "schemas/cox.component.v1.schema.json"
+  - "schemas/cox.protocol.v1.schema.json"
+  - "schemas/cox.crop_metadata.v1.schema.json"
+ToolingFiles:
+  - "LICENSE"
+  - ".gitignore"
+  - ".npmignore"
+  - "package.json"
+  - "bin/cox-protocol.js"
+  - "pyproject.toml"
+  - "requirements.txt"
+  - "templates/ComponentName.cox.template"
+  - "templates/Page.cox.template"
+  - "templates/crop_metadata.cox.template"
+  - "tools/__init__.py"
+  - "tools/cox_cli.py"
+  - "tools/cox_lib.py"
+  - "tools/package_target.py"
+  - "tools/react_target.py"
+  - "editor-support/vscode/package.json"
+  - "editor-support/vscode/language-configuration.json"
+  - "editor-support/vscode/syntaxes/cox.tmLanguage.json"
+  - "editor-support/vscode/.vscodeignore"
+  - "editor-support/vscode/LICENSE"
+  - "editor-support/vscode/README.md"
+  - "editor-support/vscode/CHANGELOG.md"
+  - "editor-support/vscode/snippets/cox-common.json"
+  - "editor-support/vscode/snippets/cox-manifest.json"
+  - "editor-support/vscode/snippets/cox-page.json"
+  - "editor-support/vscode/snippets/cox-component.json"
+  - "editor-support/vscode/snippets/cox-protocol.json"
+  - "editor-support/vscode/snippets/cox-crop-metadata.json"
+Pages:
+  - PageName: "Dashboard"
+    Slug: "dashboard"
+    Folder: "LocalAppManager/Dashboard"
+    PageInstruction: "LocalAppManager/Dashboard/dashboard.cox"
+    PageScreenshotPlaceholder: "LocalAppManager/Dashboard/dashboard_screenshot.placeholder.txt"
+    Components:
+      - Slug: "left_navigation_sidebar"
+        Folder: "LocalAppManager/Dashboard/left_navigation_sidebar"
+        ComponentInstruction: "LocalAppManager/Dashboard/left_navigation_sidebar/left_navigation_sidebar.cox"
+        ComponentScreenshotPlaceholder: "LocalAppManager/Dashboard/left_navigation_sidebar/left_navigation_sidebar_screenshot.placeholder.txt"
+      - Slug: "top_header_stats_bar"
+        Folder: "LocalAppManager/Dashboard/top_header_stats_bar"
+        ComponentInstruction: "LocalAppManager/Dashboard/top_header_stats_bar/top_header_stats_bar.cox"
+        ComponentScreenshotPlaceholder: "LocalAppManager/Dashboard/top_header_stats_bar/top_header_stats_bar_screenshot.placeholder.txt"
+      - Slug: "projects_grid_cards"
+        Folder: "LocalAppManager/Dashboard/projects_grid_cards"
+        ComponentInstruction: "LocalAppManager/Dashboard/projects_grid_cards/projects_grid_cards.cox"
+        ComponentScreenshotPlaceholder: "LocalAppManager/Dashboard/projects_grid_cards/projects_grid_cards_screenshot.placeholder.txt"
+      - Slug: "analytics_sidebar_panels"
+        Folder: "LocalAppManager/Dashboard/analytics_sidebar_panels"
+        ComponentInstruction: "LocalAppManager/Dashboard/analytics_sidebar_panels/analytics_sidebar_panels.cox"
+        ComponentScreenshotPlaceholder: "LocalAppManager/Dashboard/analytics_sidebar_panels/analytics_sidebar_panels_screenshot.placeholder.txt"
+BuildTargets:
+  - "json"
+  - "react"
+  - "package"
+VerificationRules:
+  - "Zip must contain this manifest."
+  - "Every manifest-listed .cox file must exist on disk before compilation."
+  - "Screenshots may be placeholders in this protocol package because no real screenshots were supplied in the request."
+  - "When real screenshots are supplied, placeholders must be replaced by actual image files."
+  - "Validation must parse YAML, apply JSON Schema, and check referenced paths."

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "cox-protocol-package",
+  "version": "1.0.0",
+  "description": "NPM wrapper and distribution package for the COX protocol CLI.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "cox-protocol": "./bin/cox-protocol.js"
+  },
+  "files": [
+    "bin",
+    "COX_FILE_FORMAT_SPECIFICATION_v1.0.md",
+    "LICENSE",
+    "README.md",
+    "editor-support/vscode",
+    "guides",
+    "manifest.cox",
+    "protocols",
+    "pyproject.toml",
+    "requirements.txt",
+    "schemas",
+    "skills",
+    "templates",
+    "tools",
+    "!**/__pycache__/**",
+    "!**/*.pyc",
+    "!**/*.pyo"
+  ],
+  "keywords": [
+    "cox",
+    "design-spec",
+    "schema",
+    "ui-reconstruction",
+    "agent-protocol",
+    "yaml"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/charbelmalo/cox-protocol-package.git"
+  },
+  "homepage": "https://github.com/charbelmalo/cox-protocol-package#readme",
+  "bugs": {
+    "url": "https://github.com/charbelmalo/cox-protocol-package/issues"
+  },
+  "scripts": {
+    "pack:dry-run": "npm pack --dry-run",
+    "package:vscode": "cd editor-support/vscode && npm run package",
+    "smoke:python": "cox validate . && cox compile . --target json --target react --target package --out build"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/protocols/coding_agent_starting_point.cox

@@ -0,0 +1,67 @@
+CoxVersion: "1.0"
+FileType: "protocol_doc"
+Slug: "coding_agent_starting_point"
+Schema: "cox.protocol.v1"
+ProtocolName: "Coding Agent Starting Point"
+Purpose: "Give implementation agents a staged plan for turning COX specs into working software."
+
+Mission:
+  Evidence: UserSpecified
+  Summary: "Build the UI from COX specs before wiring local system integrations."
+
+RecommendedStack:
+  Evidence: Recommended
+  Frontend: "React or Next.js with componentized layout"
+  Styling: "Tailwind or token-driven CSS variables"
+  Charts: "Recharts or similar declarative chart library"
+  Backend: "Node/Electron/Tauri/local service depending on deployment target"
+  Storage: "Local JSON or SQLite for early prototype"
+
+RepositoryStructure:
+  Evidence: Recommended
+  Example:
+    - "src/app"
+    - "src/components/shell"
+    - "src/components/projects"
+    - "src/components/analytics"
+    - "src/lib/runtime"
+    - "src/lib/storage"
+    - "src/lib/screenshots"
+    - "src/mock"
+
+ImplementationPhases:
+  - Phase: 1
+    Name: "Static visual reconstruction"
+    Tasks:
+      - "Implement layout, design tokens, and component hierarchy."
+      - "Use mocked data only."
+  - Phase: 2
+    Name: "Project discovery and metadata"
+    Tasks:
+      - "Add safe folder scanning abstraction."
+      - "Populate project cards from mocked-then-real data."
+  - Phase: 3
+    Name: "Runtime controls"
+    Tasks:
+      - "Add start/stop/restart behind explicit safe API boundaries."
+      - "Add confirmation for destructive or risky actions."
+  - Phase: 4
+    Name: "Previews and analytics"
+    Tasks:
+      - "Generate/cache screenshots."
+      - "Add commit/activity charts and AI usage provider rows."
+  - Phase: 5
+    Name: "Testing and hardening"
+    Tasks:
+      - "Add visual regression tests, accessibility checks, and state-transition tests."
+
+AcceptanceCriteria:
+  - "The UI matches COX visual hierarchy, spacing, card surfaces, and responsive behavior."
+  - "Every implemented component maps to a COX component slug."
+  - "Inferred features remain behind safe defaults."
+  - "No destructive file operation occurs without explicit confirmation."
+
+NonGoals:
+  - "Do not implement real system-level process control before visual shell is stable."
+  - "Do not assume a specific backend framework unless selected by the user."
+  - "Do not add unrelated product features beyond COX scope."

package/protocols/component_binding_graph.cox

@@ -0,0 +1,52 @@
+CoxVersion: "1.0"
+FileType: "protocol_doc"
+Slug: "component_binding_graph"
+Schema: "cox.protocol.v1"
+ProtocolName: "Component Binding Graph"
+Purpose: "Bind recurring components across pages so coding agents can implement reusable UI primitives."
+
+Components:
+  left_navigation_sidebar:
+    CanonicalRole: "Global navigation rail"
+    AppearsIn:
+      - "LocalAppManager/Dashboard"
+    SharedTokens:
+      - "Color.SurfaceGlass"
+      - "Shape.PanelRadius"
+      - "Typography.Meta"
+    ReuseGuidance: "Implement as a stable shell component when multiple pages share it."
+
+  top_header_stats_bar:
+    CanonicalRole: "Page-level header, search/actions, and KPI summary"
+    AppearsIn:
+      - "LocalAppManager/Dashboard"
+    SharedTokens:
+      - "Color.SurfaceElevated"
+      - "Shape.CardRadius"
+      - "Motion.General"
+
+  projects_grid_cards:
+    CanonicalRole: "Reusable project discovery and launch surface"
+    AppearsIn:
+      - "LocalAppManager/Dashboard"
+    SharedTokens:
+      - "Color.SurfaceGlass"
+      - "Motion.CardHover"
+      - "Shape.CardRadius"
+    ChildCandidates:
+      - "project_card_preview_stage"
+      - "project_card_metadata"
+      - "project_card_runtime_badges"
+
+  analytics_sidebar_panels:
+    CanonicalRole: "Right-side status, activity, and usage analytics stack"
+    AppearsIn:
+      - "LocalAppManager/Dashboard"
+    SharedTokens:
+      - "Color.SurfaceGlass"
+      - "Motion.ChartLoad"
+
+BindingRules:
+  - "If the same visual/behavioral component appears on multiple pages, keep the same component slug."
+  - "If the same component changes layout by viewport, use responsive variants, not a new component name."
+  - "If a component changes purpose, create a new component slug even if it looks similar."

package/protocols/design_tokens.cox

@@ -0,0 +1,42 @@
+CoxVersion: "1.0"
+FileType: "protocol_doc"
+Slug: "design_tokens"
+Schema: "cox.protocol.v1"
+ProtocolName: "Design Tokens"
+Purpose: "Reusable visual system tokens shared by all Page and Component .cox files."
+
+Color:
+  BackgroundCanvas: "soft white / misty blue glass canvas"
+  SurfaceGlass: "translucent white surface with subtle blue-gray stroke"
+  SurfaceElevated: "slightly brighter translucent card with soft shadow"
+  PrimaryAccent: "blue-violet gradient"
+  SuccessAccent: "green for running, healthy, positive deltas"
+  WarningAccent: "amber for stopped, paused, degraded states"
+  ErrorAccent: "red for destructive or unavailable states"
+  MutedText: "blue-gray secondary copy"
+  PrimaryText: "near-black high contrast text"
+
+Typography:
+  FontFamily: "native system UI stack"
+  Heading: "bold, compact, high contrast"
+  Body: "medium weight, readable, neutral"
+  Meta: "small, muted, structured"
+
+Shape:
+  CardRadius: "large rounded macOS-style corners"
+  ButtonRadius: "pill or rounded-rect"
+  PanelRadius: "large soft rectangle"
+
+Spacing:
+  PagePadding: "generous desktop spacing, reduced mobile spacing"
+  CardGap: "consistent grid rhythm"
+  InnerPadding: "comfortable card and panel padding"
+
+Motion:
+  General: "smooth native-feeling transitions"
+  CardHover: "subtle lift and shadow increase"
+  Menu: "fade and slight scale"
+  ChartLoad: "fluid line/area animation"
+
+UsageRule:
+  - "Reference tokens by name inside .cox files instead of restating full styles repeatedly."

package/protocols/deterministic_naming_convention.cox

@@ -0,0 +1,159 @@
+CoxVersion: "1.0"
+FileType: "protocol_doc"
+Slug: "deterministic_naming_convention"
+Schema: "cox.protocol.v1"
+ProtocolName: "Deterministic Naming Convention"
+Purpose: "Resolve visual-to-spec naming ambiguity using a stable recursive naming formula."
+AppliesTo:
+  - "ProjectName"
+  - "PageName"
+  - "ComponentName"
+  - "ComplexSubcomponentName"
+  - "Screenshot file names"
+  - ".cox file names"
+
+GlobalRules:
+  ProjectName:
+    Format: "PascalCase"
+    Example: "LocalAppManager"
+    SourcePriority:
+      - "User-provided project name"
+      - "Visible product/app title"
+      - "Conversation-derived product purpose"
+      - "Fallback: Project"
+  PageName:
+    Format: "PascalCase"
+    Example: "Dashboard"
+    SourcePriority:
+      - "Visible page title"
+      - "User-provided page name"
+      - "Dominant route or workflow name"
+      - "Canonical page taxonomy"
+      - "Fallback: Page01, Page02"
+  ComponentName:
+    Format: "lowercase_snake_case"
+    Example: "projects_grid_cards"
+  ComplexSubcomponentName:
+    Format: "lowercase_snake_case"
+    Example: "project_card_preview_stage"
+  ForbiddenFinalNamePatterns:
+    - "screenshot_001"
+    - "image_1"
+    - "screen_final"
+    - "capture_date_time"
+    - "temp"
+    - "copy"
+    - "untitled"
+
+SlugResolutionOrder:
+  - Step: 1
+    Rule: "Use explicit user-provided semantic name if supplied."
+  - Step: 2
+    Rule: "Use visible title/header text if it clearly identifies the section."
+  - Step: 3
+    Rule: "Use dominant UI region role."
+  - Step: 4
+    Rule: "Use component type plus primary content domain."
+  - Step: 5
+    Rule: "Use canonical taxonomy."
+  - Step: 6
+    Rule: "Add a short differentiator if two names are too close."
+  - Step: 7
+    Rule: "Append numeric suffix only for true same-role siblings after semantic differentiation fails."
+
+ComponentNameFormula:
+  PreferredPattern: "{domain_or_purpose}_{layout_or_component_type}_{optional_distinguishing_trait}"
+  MinimalExamples:
+    - "left_navigation_sidebar"
+    - "top_header_stats_bar"
+    - "projects_grid_cards"
+    - "analytics_sidebar_panels"
+    - "runtime_status_toolbar"
+    - "project_card_preview_stage"
+  AvoidOverSpecificExamples:
+    Bad: "nested_sidebar"
+    Reason: "Too open to interpretation."
+    Better: "left_navigation_sidebar"
+  AvoidNearDuplicateExamples:
+    BadPair: ["left_sidebar", "left_navigation"]
+    Reason: "Too close; both may refer to same visual region."
+    BetterPair: ["left_navigation_sidebar", "project_filters_sidebar"]
+
+CanonicalComponentTaxonomy:
+  Navigation:
+    - "left_navigation_sidebar"
+    - "top_navigation_bar"
+    - "breadcrumb_trail"
+    - "tab_navigation"
+  Header:
+    - "top_header_bar"
+    - "top_header_stats_bar"
+    - "page_title_toolbar"
+  Content:
+    - "projects_grid_cards"
+    - "detail_content_panel"
+    - "settings_form_panel"
+    - "activity_feed_list"
+  Analytics:
+    - "analytics_sidebar_panels"
+    - "usage_metrics_chart"
+    - "commit_activity_chart"
+  Controls:
+    - "floating_action_button"
+    - "filter_sort_toolbar"
+    - "search_command_input"
+    - "runtime_status_toolbar"
+  Feedback:
+    - "empty_state_panel"
+    - "error_state_banner"
+    - "loading_skeleton_grid"
+    - "confirmation_modal"
+
+AmbiguityValidationPass:
+  Objective: "Ensure names are easy to understand, distinguishable, and recursively stable."
+  Checks:
+    - NameIsSemantic: "Name describes purpose or visible role, not crop position alone."
+    - NameIsNotTooGeneric: "Avoid component, section, panel, area unless qualified."
+    - NameIsNotTooSpecific: "Avoid long descriptions that hide the concept."
+    - NameIsNotNearDuplicate: "Reject sibling names that differ only by vague synonyms."
+    - NameHasStableScope: "Name still makes sense if the screenshot is reused later."
+  NearDuplicateResolution:
+    - "Compare sibling slugs inside the same page folder."
+    - "If two names share same head noun and unclear differentiator, rename one using purpose/domain."
+    - "Prefer relation-preserving pairs: navigation sidebar vs filters sidebar, not sidebar_a vs sidebar_b."
+
+RecursiveNamingPattern:
+  PageLevel:
+    Folder: "{ProjectName}/{PageName}/"
+    Instruction: "{page_slug}.cox"
+    Screenshot: "{page_slug}_screenshot.{ext}"
+  ComponentLevel:
+    Folder: "{ProjectName}/{PageName}/{component_slug}/"
+    Instruction: "{component_slug}.cox"
+    Screenshot: "{component_slug}_screenshot.{ext}"
+  ComplexSubcomponentLevel:
+    Folder: "{ProjectName}/{PageName}/{component_slug}/{subcomponent_slug}/"
+    Instruction: "{subcomponent_slug}.cox"
+    Screenshot: "{subcomponent_slug}_screenshot.{ext}"
+
+ResponsiveVariantNaming:
+  Rule: "Keep variants attached to the same page or component unless the variant introduces a materially different layout."
+  PageVariantPattern: "{page_slug}_screenshot_{viewport}.{ext}"
+  ComponentVariantPattern: "{component_slug}_screenshot_{viewport}.{ext}"
+  AllowedViewportSuffixes:
+    - "desktop"
+    - "tablet"
+    - "mobile"
+  Examples:
+    - "dashboard_screenshot_desktop.png"
+    - "dashboard_screenshot_mobile.png"
+    - "projects_grid_cards_screenshot_tablet.png"
+
+FinalNamingDecisionRecord:
+  RequiredInEachCoxFile: true
+  Fields:
+    - "ChosenName"
+    - "Reason"
+    - "RejectedAlternatives"
+    - "AmbiguityRisk"
+    - "EvidenceLevel"

package/protocols/evidence_and_uncertainty_protocol.cox

@@ -0,0 +1,42 @@
+CoxVersion: "1.0"
+FileType: "protocol_doc"
+Slug: "evidence_and_uncertainty_protocol"
+Schema: "cox.protocol.v1"
+ProtocolName: "Evidence And Uncertainty Protocol"
+Purpose: "Prevent agents from confusing visible evidence, user requirements, inference, and recommendations."
+
+EvidenceLevels:
+  Visible:
+    Definition: "Directly shown in the screenshot."
+    Example: "A left sidebar exists."
+  UserSpecified:
+    Definition: "Explicitly stated in the conversation or uploaded requirements."
+    Example: "Package must use .cox files."
+  Inferred:
+    Definition: "Reasonable assumption from screenshot context or common app behavior."
+    Example: "Status dot likely maps to running/stopped state."
+  Intended:
+    Definition: "Desired behavior implied by the product direction but not directly visible."
+    Example: "Charts animate smoothly on load."
+  Recommended:
+    Definition: "Best-practice addition that helps implementation but was not requested or visible."
+    Example: "Add keyboard navigation to project cards."
+
+RequiredUse:
+  - "Every behavior in protocols/website_logic_and_functionality.cox must include an evidence level."
+  - "Every component .cox must include EvidenceSummary, VisibleStructure, and Interactions, with visible, inferred, intended, and recommended behavior clearly labeled inside those sections."
+  - "Security, persistence, runtime controls, analytics, and AI-provider metrics must not be marked Visible unless actually shown."
+
+ClaimStyle:
+  Allowed:
+    - "Visible: The card grid uses rounded glass cards."
+    - "Inferred: Clicking a project card opens or launches the project."
+    - "Recommended: Add confirmation before destructive file operations."
+  Forbidden:
+    - "The app definitely launches projects from the grid" # unless visible/user-specified
+    - "The backend uses Node.js" # unless supplied
+
+CoxFileRequiredSections:
+  - "EvidenceSummary"
+  - "VisibleStructure"
+  - "Interactions"

package/protocols/llm_agent_zip_recreation_instructions.cox

@@ -0,0 +1,87 @@
+CoxVersion: "1.0"
+FileType: "protocol_doc"
+Slug: "llm_agent_zip_recreation_instructions"
+Schema: "cox.protocol.v1"
+ProtocolName: "LLM Agent ZIP Recreation Instructions"
+Purpose: "Teach coding/design LLM agents how to recreate complete design-spec ZIP packages from screenshots and requirements."
+Name: "COX deterministic design binding protocol"
+Extension: ".cox"
+OutputArtifact: "single downloadable zip containing screenshots, partitioned screenshots, .cox files, manifests, implementation docs, and validation reports"
+ProjectAgnostic: true
+
+RequiredBehavior:
+  - "Do not assume files were created unless they exist on disk."
+  - "Preserve user-provided visual intent, naming conventions, and project vocabulary."
+  - "Use deterministic folder names, file names, and document structures."
+  - "Use .cox as the canonical design/spec/instruction file extension."
+  - "Mark uncertain behavior as Inferred, Intended, or Recommended."
+  - "Never describe invisible features as certain unless user-specified."
+  - "Use recursive decomposition only when it improves clarity."
+
+CanonicalOutputStructure:
+  ProjectFolder: "{ProjectName}/"
+  PageFolder: "{ProjectName}/{PageName}/"
+  PageInstructionFile: "{ProjectName}/{PageName}/{page_slug}.cox"
+  PageScreenshotFile: "{ProjectName}/{PageName}/{page_slug}_screenshot.{extension}"
+  ComponentFolder: "{ProjectName}/{PageName}/{component_slug}/"
+  ComponentInstructionFile: "{ProjectName}/{PageName}/{component_slug}/{component_slug}.cox"
+  ComponentScreenshotFile: "{ProjectName}/{PageName}/{component_slug}/{component_slug}_screenshot.{extension}"
+  ComplexSubcomponentFolder: "{ProjectName}/{PageName}/{component_slug}/{subcomponent_slug}/"
+  ComplexSubcomponentInstructionFile: "{ProjectName}/{PageName}/{component_slug}/{subcomponent_slug}/{subcomponent_slug}.cox"
+  ComplexSubcomponentScreenshotFile: "{ProjectName}/{PageName}/{component_slug}/{subcomponent_slug}/{subcomponent_slug}_screenshot.{extension}"
+
+RootPackageDocs:
+  - "README.md"
+  - "protocols/llm_agent_zip_recreation_instructions.cox"
+  - "protocols/deterministic_naming_convention.cox"
+  - "protocols/recursive_decomposition_protocol.cox"
+  - "protocols/screenshot_partitioning_protocol.cox"
+  - "protocols/evidence_and_uncertainty_protocol.cox"
+  - "protocols/sub_agents_orchestration.cox"
+  - "protocols/design_tokens.cox"
+  - "protocols/component_binding_graph.cox"
+  - "protocols/website_logic_and_functionality.cox"
+  - "protocols/coding_agent_starting_point.cox"
+  - "protocols/visual_acceptance_checklist.cox"
+  - "manifest.cox"
+
+Workflow:
+  Step01_CollectInputs:
+    Actions:
+      - "List all screenshots, crops, mockups, visual references, existing zips, and user requirements."
+      - "Open/inspect each image visually."
+      - "Record original file names before renaming."
+  Step02_ConstructHierarchy:
+    Actions:
+      - "Identify ProjectName."
+      - "Identify PageName for each full-screen or page-level screenshot."
+      - "Attach responsive variants at the page level unless they are isolated component variants."
+      - "Map each page screenshot to exactly one Page folder."
+  Step03_RecursiveDecomposition:
+    Actions:
+      - "Keep simple pages as one {page_slug}.cox file."
+      - "Split complex pages into distinguishable component folders."
+      - "Split components into subcomponents only when naming or reasoning becomes ambiguous."
+  Step04_DeterministicNaming:
+    Actions:
+      - "Generate names using the slug resolution ladder."
+      - "Run ambiguity and near-duplicate validation."
+      - "Prefer names that balance differentiation and relation."
+  Step05_PartitionScreenshots:
+    Actions:
+      - "Estimate section boundaries and crop components where possible."
+      - "Use border/region estimation without inventing hidden layout."
+      - "Preserve original full-page screenshot at page level."
+  Step06_WriteCoxFiles:
+    Actions:
+      - "Create {page_slug}.cox for every page folder."
+      - "Create component_slug.cox for every component folder."
+      - "Create subcomponent_slug.cox only for complex subcomponent folders."
+  Step07_GenerateGlobalDocs:
+    Actions:
+      - "Write manifest, design tokens, component graph, logic doc, coding-agent doc, and acceptance checklist."
+  Step08_VerifyAndZip:
+    Actions:
+      - "Verify every referenced file exists on disk."
+      - "List zip contents after compression."
+      - "Do not claim completion unless the zip exists and contains expected files."