claudegoodies
CLAUDE.md

open-codesign CLAUDE.md

From OpenCoworkAI

Instructions for Claude Code (and any AI coding agent) working in this repository. Read this before making changes.

Defines architecture, stack, and hard constraints for contributing to open-codesign, an Electron app generating design artifacts from prompts.

Use it when

  • Contributing code to the open-codesign Electron/React monorepo
  • Adding a dependency or provider integration and checking it's permitted
  • Implementing export features (PPTX, PDF) that must lazy-load
  • Deciding on state/storage approach and needing the locked local-first rules

Skip it if

  • Locked to a specific stack: pnpm, Biome, Zustand, Tailwind v4, pi-ai only
  • Requires internal docs/ (gitignored) for full context, unavailable to public contributors
  • Not useful outside this specific repository's codebase

Facts

Repository
OpenCoworkAI/open-codesign
Status
Actively maintained
Last commit
Source file
CLAUDE.md

Source preview

The instructions Claude Code reads when this claude.md runs.

# CLAUDE.md — Open CoDesign

Instructions for Claude Code (and any AI coding agent) working in this repository. Read this before making changes.

## What this project is

open-codesign is an Electron desktop app that turns natural-language prompts into design artifacts (HTML prototypes, PDFs, PPTX decks, marketing assets). It's the open-source counterpart to Anthropic's Claude Design, with multi-provider model support via `pi-ai` and a local-first storage model.

The full vision and locked decisions live in `docs/VISION.md` when the internal docs are present locally. Public checkouts may not have `docs/`; in that case use `AGENTS.md`, public issues/PRs, and README context instead of blocking.

> Note: `docs/` is gitignored — internal team materials (research, roadmaps, handoffs) live there but are not part of the public repo. Clone contributors will not have this directory; team members will find it present locally after cloning and copying the internal docs back.

## Hard constraints (do not violate)

These are project-level commitments, not preferences:

1. **No bundled model runtimes.** No Ollama, llama.cpp, Python, or browser binaries shipped in the installer. Use system installs or lazy-download on demand.
2. **BYOK only.** No proxied API calls, no cloud account, no telemetry by default. User credentials stay in `~/.config/open-codesign/config.toml` (plaintext, file mode 0
View full source on GitHub →

Other claude.md files