Skip to content

docs: restructure agentic context for progressive disclosure#62

Merged
jvcorredor merged 1 commit intomainfrom
worktree-fix-ip-forward-startup
Mar 30, 2026
Merged

docs: restructure agentic context for progressive disclosure#62
jvcorredor merged 1 commit intomainfrom
worktree-fix-ip-forward-startup

Conversation

@jvcorredor
Copy link
Copy Markdown
Contributor

Summary

  • Rewrite AGENTS.md with Quick Start (worktree requirement front and center), git workflow, safety boundaries, testing patterns, and references sections (~150 lines, down from 248)
  • Move planning docs (AUDIT.md, AUTHENTICATION.md, IMPROVEMENTS.md, SEO.md) from root to doc/
  • Create .claude/README.md documenting hooks, skills, and settings
  • Expand backend/README.md with local setup, collections, migrations, and deployment steps
  • Add "For AI Agents" pointer in README.md
  • Also includes prior fixes: book description truncation and event date off-by-one

Test plan

  • Build passes
  • CLAUDE.md symlink resolves correctly
  • Root only contains README.md, AGENTS.md, CLAUDE.md
  • Moved docs accessible at doc/*.md
  • Aligned with recommendations from Anthropic, LogRocket, agents.md, and Context Studios research

🤖 Generated with Claude Code

- Rewrite AGENTS.md: Quick Start at top with worktree requirement,
  add git workflow and safety boundaries sections, add testing
  patterns, add references to deeper docs (~150 lines, down from 248)
- Move planning docs to doc/: audit.md, authentication.md,
  improvements.md, seo.md (root now only README + CLAUDE.md)
- Create .claude/README.md documenting hooks, skills, and settings
- Expand backend/README.md with local setup, collections, migrations,
  and deployment steps
- Add "For AI Agents" pointer in README.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify bot commented Mar 30, 2026

Deploy Preview for cscsdev ready!

Name Link
🔨 Latest commit 2ff7ea8
🔍 Latest deploy log https://app.netlify.com/projects/cscsdev/deploys/69ca892f2284620008db0ac5
😎 Deploy Preview https://deploy-preview-62--cscsdev.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@jvcorredor jvcorredor merged commit 3158d47 into main Mar 30, 2026
5 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