docs: 📝 added project context for ai agents

[sabucds]

Summary by CodeRabbit

• Documentation
  • Added references to new Project Context and Code Style guides.
  • Added a comprehensive Project Context document for the Concert Ticket Booking Platform.
  • Removed ADR guidance from the architecture guide and consolidated ADR-related rules into the development workflow.
  • Replaced the detailed Development Workflow with a shorter canonical workflow.
  • Removed a short example test block from the testing docs.

[coderabbitai]

Note

.coderabbit.yaml has unrecognized properties

CodeRabbit is using all valid settings from your configuration. Unrecognized properties (listed below) have been ignored and may indicate typos or deprecated fields that can be removed.

⚠️ Parsing warnings (1)

Validation error: Unrecognized key(s) in object: 'checks', 'custom_review_instructions'

⚙️ Configuration instructions

• Please see the configuration documentation for more information.
• You can also validate your configuration using the online YAML validator.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

No actionable comments were generated in the recent review. 🎉

---

Walkthrough

Reorganized documentation: ADR guidance removed from ARCHITECTURE.md and consolidated into WORKFLOW.md; added a new PROJECT_CONTEXT.md describing the Concert Ticket Booking Platform; updated CLAUDE.md references; removed an example test snippet from TESTING.md.

Changes

Cohort / File(s)	Summary
Documentation References CLAUDE.md	Added bullets referencing docs/agent/PROJECT_CONTEXT.md and docs/agent/CODE_STYLE.md; minor whitespace cleanup.
ADR Guidance Relocation docs/agent/ARCHITECTURE.md, docs/agent/WORKFLOW.md	Removed ADR guidance from ARCHITECTURE.md and introduced/clarified ADR rules and placement in WORKFLOW.md (relocates ADR criteria and requirements to workflow doc).
Project Context Added docs/agent/PROJECT_CONTEXT.md	New file describing project overview, personas, MVP scope, non-functional requirements, high-level microservices architecture, communication patterns, scalability intent, and AI-first development workflow for the Concert Ticket Booking Platform.
Testing Example Removed docs/agent/TESTING.md	Removed the Example (short) test code block and associated example test setup from the testing docs.
Code Style Doc (referenced) docs/agent/CODE_STYLE.md	Referenced from CLAUDE.md (file addition implied by reference; verify presence/contents).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title references adding project context, which aligns with the primary change (new PROJECT_CONTEXT.md file), but oversimplifies the broader refactoring across CLAUDE.md, ARCHITECTURE.md, WORKFLOW.md, and TESTING.md.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch docs/project-context

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

📊 Code Coverage Report

Overall Project	62.09%	❌

There is no coverage information present for the Files changed

[github-actions]

🧪 Test Results

234 tests   234 ✅  11s ⏱️
 34 suites    0 💤
 34 files      0 ❌

Results for commit 4fd9eeb.