docs: reorganize ops runbooks, scripts, and CLAUDE.md#136
Open
MrCoder wants to merge 4 commits into
Open
Conversation
Extract Forge auth, analytics, ops, client privacy, and spot-check guidance into dedicated docs and a spot-check skill so agents load essentials inline and pull depth on demand. Co-authored-by: Cursor <cursoragent@cursor.com>
- Compress Git Workflow section: safety constraint (never disrupt
another session's working tree) stays inline; branching protocol
deferred to new docs/policies/git-workflow.md
- Add forward pointer to docs/policies/forge-only.md under Pure Forge
- Tighten Analytics stub: keep page_viewed gotcha + project ID,
defer full detail to docs/analytics-reference.md
- Remove dead links to docs/agents/{issue-tracker,triage-labels,domain}.md
(those files never existed; content was already inline)
Co-authored-by: Cursor <cursoragent@cursor.com>
Restructure flat list of 15 unevenly-weighted H2s into 7 H2 buckets with consistent content weight so the skim matches the mental model: Project orientation / Hard rules / Architecture / Local development / Operations / Browser automation / Agent skills. Content changes: - Project overview now mirrors the DiagramType enum (5 first-class types Sequence, Mermaid, PlantUml, Graph, OpenApi) instead of the prior three-bucket lossy framing that omitted PlantUML - All four hard rules grouped: Pure Forge, Client privacy, never commit to main, never disrupt another session's working tree - Database setup moved next to Build & test (both are local-dev tasks) - Cloudflare Pages, Stripe webhook, Analytics demoted from H2 stubs to H3 siblings under Operations - Browser automation kept as top-level H2 (load-bearing orientation) Removed dead weight: - E2E test principles (generic Playwright advice + a narrow historical fix that belongs in a code comment, not always-loaded context) - Linting subsection (one line restating a package.json script) - Stripe webhook subsection (only relevant to ~5% of sessions; agent touching billing will grep "stripe") - Key Dependencies (low orientation value; discoverable from package.json) Co-authored-by: Cursor <cursoragent@cursor.com>
… up legacy files Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
operations/runbooks →docs/ops/(diagramly-forge-app, full-app, lite-forge-app, staging-release-process)operations/ecohelp-labels/→scripts/ecohelp-labels/.eslintrc.js,.firebaserc,IMPLEMENTATION_PLAN.mdCLAUDE.mdandCONTEXT.mdstructure (regroup sections, fix dead references, slim runbook refs to point at newdocs/paths)copy-macro-workspaceeval artifacts,create-test-pagefixtures/scripts,forge-installs/check.pyscripts/connect-jwt-probe.mjsrelease-appSKILL.mdTest plan
src/behavioral changes🤖 Generated with Claude Code