Skip to content

Refactor knowledge.md into AGENTS.md + docs/#480

Merged
jahooma merged 3 commits intomainfrom
jahooma/refactor-knowledge-to-docs
Mar 26, 2026
Merged

Refactor knowledge.md into AGENTS.md + docs/#480
jahooma merged 3 commits intomainfrom
jahooma/refactor-knowledge-to-docs

Conversation

@jahooma
Copy link
Copy Markdown
Contributor

@jahooma jahooma commented Mar 26, 2026

Summary

  • Renamed knowledge.md to AGENTS.md, now a lightweight table of contents
  • Extracted detailed docs into dedicated files under docs/: development, testing, environment variables, agents & tools, git guidelines, error handling
  • Existing docs (architecture.md, request-flow.md, error-schema.md) now linked from AGENTS.md alongside the new files

Test plan

  • Verify all doc links in AGENTS.md resolve correctly
  • Confirm no broken references to knowledge.md in active code paths

🤖 Generated with Claude Code

Move detailed documentation from knowledge.md into dedicated files
under docs/, keeping AGENTS.md as a lightweight table of contents.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jahooma and others added 2 commits March 26, 2026 11:30
error-handling.md (2 lines) and git-guidelines.md (3 bullets) were too
thin for their own files. Moved them into a Conventions section in
AGENTS.md alongside the referral system note. Restored the brief
request flow summary that was in the original knowledge.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The test imports db/index.ts which eagerly calls postgres() and drizzle()
at the top level. In CI, the dummy DATABASE_URL produces a client without
options.parsers/serializers, crashing drizzle's construct(). Mock both
postgres and @codebuff/internal/env before importing to avoid the real
db initialization — the test only ever spies on db.transaction anyway.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jahooma jahooma merged commit 224d6e1 into main Mar 26, 2026
34 checks passed
@jahooma jahooma deleted the jahooma/refactor-knowledge-to-docs branch March 26, 2026 18:51
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