Skip to content

Add CLAUDE.md pointing at the private operational notes - #23

Merged
zerotrustdavid merged 1 commit into
mainfrom
claude/document-review-questions-67ijhw
Sep 5, 2026
Merged

Add CLAUDE.md pointing at the private operational notes#23
zerotrustdavid merged 1 commit into
mainfrom
claude/document-review-questions-67ijhw

Conversation

@zerotrustdavid

@zerotrustdavid zerotrustdavid commented Sep 5, 2026

Copy link
Copy Markdown
Owner

Records where the operational and security notes live, so work on this repository starts by reading them rather than rediscovering the same things.

The notes are in zerotrustdavid/invision-security-notes, which is private. That repository carries the protocol in full; this file is the pointer to it.

What is in the file

Only what is safe to state in a public repository:

  • Where the notes live, and that they are read before work starts rather than consulted afterwards
  • The two failure modes that break the live site: NEXT_PUBLIC_ values needing a redeploy, and the Web3Forms captcha toggle rejecting every submission because the forms send no token
  • The load-bearing CSP directive, connect-src 'self' https://api.web3forms.com
  • The single-key rule in src/lib/mailboxes.ts, and why the ?? FALLBACK chain must not come back
  • Repository conventions

What is deliberately not in it

Which security controls are and are not currently in force. That belongs in the private repository and stays there. This file states that the repository is public and that such detail does not go in it.

Note on the trade-off

This names a private repository in a public one. Nobody gains access from that, they only learn it exists. The alternative was gesturing at it without naming it, which would leave a session unable to act without asking first. The explicit pointer was chosen deliberately so the protocol works unattended.

No code or configuration changes. Documentation only.

Records where the operational and security notes live, and that they are read
before work starts rather than consulted afterwards.

Carries only what is safe to state publicly: the two failure modes that break
the live site, the load-bearing CSP directive, and the single-key rule. Which
controls are and are not in force stays in the private repository.
@vercel

vercel Bot commented Sep 5, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
invisionsolutions Ready Ready Preview Sep 5, 2026 1:29am UTC

@zerotrustdavid
zerotrustdavid merged commit d9edc91 into main Sep 5, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant