docs: restructure AI instruction files

[nanotaboada]

This change is 

Summary by CodeRabbit

• Documentation
  • Updated development guides and architecture documentation with expanded Quick Start, API endpoints, and workflow sections.

[coderabbitai]

Warning

Rate limit exceeded

@nanotaboada has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 17 minutes and 15 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Walkthrough

Two documentation files are restructured: .github/copilot-instructions.md is expanded from terse pointers to a comprehensive guide covering Quick Start, Architecture, and CI/CD sections; AGENTS.md is reorganized from prescriptive step-by-step instructions to autonomy-focused guidelines with workflow examples and design principles. No code or runtime logic is affected.

Changes

Cohort / File(s)	Summary
Copilot Instructions .github/copilot-instructions.md	Expanded from brief notes into a detailed multi-section guide with Quick Start, Architecture, API endpoints, CI/CD workflows, and conventions sections including code blocks and directory structures.
Agent Instructions AGENTS.md	Restructured from prescriptive operational commands and step-by-step setup instructions to autonomy guidelines (Proceed Freely vs. Ask First), workflow topics (routing, services, testing), and design philosophy with inline code examples.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• PR #437: Modifies .github/copilot-instructions.md to add comprehensive guidance for project setup and conventions.
• PR #481: Updates AGENTS.md with overlapping documentation changes around release workflows and changelog management.
• PR #471: Modifies both .github/copilot-instructions.md and AGENTS.md to address AI agent documentation loading strategy with different approaches to content organization.

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title follows Conventional Commits format with 'docs:' prefix, is under 80 characters (38 chars), and accurately describes the main change of restructuring AI instruction files (.github/copilot-instructions.md and AGENTS.md).
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection	✅ Passed	✅ No merge conflicts detected when merging into master

_{✏️ 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/restructure-ai-instructions

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[coderabbitai]

Actionable comments posted: 2

🤖 Fix all issues with AI agents

In @.github/copilot-instructions.md:
- Around line 171-174: The fenced code block currently uses triple backticks
with no language specifier; update that block (the snippet starting with ``` and
containing the two commit lines) to include a language identifier (e.g., change
``` to ```text or ```diff) so syntax highlighting and linting recognize the
content.
- Around line 42-47: Add a language identifier to the Markdown fenced code block
in .github/copilot-instructions.md by updating the opening fence from ``` to
```text (or ```plaintext) so the block starting with "Request → Routes →
Services → SQLAlchemy → SQLite" is recognized by markdown linters; ensure only
the opening fence is changed and the closing fence remains ``` unchanged.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.65%. Comparing base (facea4e) to head (eefbcb5).
⚠️ Report is 3 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #486   +/-   ##
=======================================
  Coverage   89.65%   89.65%           
=======================================
  Files           3        3           
  Lines         116      116           
=======================================
  Hits          104      104           
  Misses         12       12           

Components	Coverage Δ
Services	79.31% <ø> (ø)
Routes	100.00% <ø> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud