Files
Prism-Notes-Main/logs/DEVIATIONS.txt
T

62 lines
3.0 KiB
Plaintext

================================================================================
PRISM NOTES - NON-STANDARD BUT ACCEPTED DEVIATIONS
Quick reference for intentional deviations from Monica's core standards
================================================================================
================================================================================
DEVIATION: Vanilla JavaScript Frontend + CDN Tailwind
================================================================================
Reasoning: Project initiated with quick frontend setup allowing rapid iteration
without TypeScript compilation or build tool overhead. Acceptable at prototype
stage; frontend logic primarily orchestration rather than complex business logic.
Affected Files: index.html (all inline <script> blocks, <script src=""> CDN links)
Current Scope: Screen capture tools, form submission, auth UI
Implications:
- Loss of type safety on frontend (no `.ts` checks, IDE autocomplete limited)
- Slower asset loading (no bundling, no minification)
- Harder to maintain as project scales (intermingled concerns)
- No separate build step (frontend compiled inline)
Standards Violated:
- LANGUAGE: TypeScript (Frontend & Backend) → Using vanilla JS instead
- STYLING: TailwindCSS + PostCSS → Using CDN instead of build pipeline
Adopted: 2026-01-14
Review Date: 2026-02-14
Triggers for Conversion:
- Frontend code exceeds 500 LOC
- Team grows beyond 1 person
- Screen capture feature stabilizes
- Build automation becomes necessary for other features
Reviewed: No
Reviewer: Monica
================================================================================
DEVIATION: Tool Files Use Vanilla JavaScript (.js)
================================================================================
Reasoning: Standalone utility tools (screen-capture, screen-record, user-alert)
designed as reusable browser-side modules. Vanilla JS allows direct browser
execution without build step. Tools are self-contained utilities, not critical
business logic. Conversion to TypeScript not necessary at current maturity.
Affected Files:
- /tools/screen-capture/index.js (246 LOC)
- /tools/screen-record/index.js (165 LOC)
- /tools/user-alert/index.js (196 LOC)
Implications:
- Loss of type safety on tool internals (no IDE autocomplete, no .ts checks)
- Tools cannot be used in strict TypeScript environments without @ts-ignore
- Maintenance slightly harder as tool complexity grows
Standards Violated:
- LANGUAGE: TypeScript (Frontend & Backend) → Using vanilla JS instead
Adopted: 2026-01-14
Review Date: 2026-03-01
Triggers for Conversion:
- Tools grow beyond 250 LOC each
- Tools need to interact with backend types
- Tool suite grows to >5 tools
- Performance optimization requires bundling
Reviewed: No
Reviewer: Monica
================================================================================
END OF DEVIATIONS LOG
================================================================================