verify-architecture

name	verify-architecture
description	Verify ClaudeVille follows its architectural rules - layer structure, adapter pattern, CLAUDE.md conventions, and file organization. Trigger after adding new files, refactoring, or modifying project structure.

Architecture Verification

Verify the ClaudeVille project adheres to its documented architecture and conventions defined in CLAUDE.md.

Check Items

1. Layer Structure

Verify claudeville/src/ follows the defined layers:

src/
├── domain/          (entities, value-objects, events)
├── application/     (managers, services)
├── infrastructure/  (WebSocketClient, data sources)
├── presentation/    (renderers, UI components)
│   ├── character-mode/
│   ├── dashboard-mode/
│   └── shared/
└── config/          (constants, theme, i18n, buildings)

• PASS: All directories exist with appropriate files
• WARN: Empty directories or misplaced files
• FAIL: Missing core directories (domain, application, presentation)

2. No Framework Dependencies

Verify the project uses pure HTML/CSS/JS with no npm dependencies:

• package.json should only have scripts, no dependencies or devDependencies

• No node_modules/ directory

• All imports use relative paths or ES modules

• PASS: No external dependencies

• FAIL: npm dependencies found

3. Adapter Pattern Compliance

Verify claudeville/adapters/ follows the multi-provider pattern:

• index.js exists and acts as registry

• Each adapter (claude.js, codex.js, gemini.js) exports consistent interface

• Adapters detect installed CLIs, not hard-require them

• PASS: All adapters present with consistent exports

• WARN: Adapter missing but referenced in index.js

• FAIL: index.js missing or broken adapter interface

4. CSS Convention

Verify no position: fixed in CSS files (except modal/toast as per CLAUDE.md rules):

grep -rn "position.*fixed" claudeville/css/ --include="*.css"

Allowed exceptions: modal.css, toast-related code

• PASS: No violations or only in allowed files
• FAIL: position: fixed in layout/sidebar/topbar CSS files

5. ES Module Consistency

Verify all JS files in src/ use ES module syntax:

• Files should use import/export, not require()/module.exports

• Exception: server.js and adapters/ (Node.js CommonJS)

• PASS: All src/ files use ES modules

• FAIL: Mixed module systems in src/

6. Port Configuration

Verify server port is 4000 as documented in CLAUDE.md:

• claudeville/CLAUDE.md mentions port 4000

• claudeville/server.js uses const PORT = 4000

• PASS: Port 4000 documented and configured

• FAIL: Port mismatch or not documented

7. Widget Integration

Verify widget directory follows the documented structure:

widget/
├── Sources/main.swift
├── Resources/
│   ├── widget.html
│   └── widget.css
├── Info.plist
└── build.sh          (must be executable)

• PASS: All files present, build.sh executable
• WARN: widget.html/css exist but are stale (widget uses Swift-generated HTML now)
• FAIL: Missing main.swift or build.sh