docs: adopt LiteLLM + AI patterns from Resume-Matcher, add docs/agent - #3
Merged
Merged
Conversation
Review the reference project srbhr/Resume-Matcher and fold its applicable patterns into the design: - API backends now go through LiteLLM behind Atlas's LLMProvider interface (CLI adapters stay custom subprocess adapters); add $5.1a for its design. - Specify the complete_json() layered structured-output recovery: native field -> brace-balancing extraction -> content retry with temperature escalation -> JSON-mode to prompt-only fallback, distinct from Router transport retries. - Add diff-mode tailoring (skill-target plan -> diffs -> apply -> verify) with full-output fallback, plus deterministic post-LLM safety nets (personal-info/date/skill preservation, month-precision date restore) and an AI-phrase scrub to $5.7 and $11. - Register model capabilities from a registry, single resolve_api_key() with local providers skipping the env-key fallback. - Update tech stack, layout, testing ($16), resolved decisions ($18), and add $19 documenting the reference review.
Add a task-oriented agent documentation set modeled on the reference project's docs/agent layout: index, scope-and-principles, architecture, llm-integration, coding-standards, testing-strategy, and workflow. Each doc points back to AGENTS.md and PROJECT.md as the authoritative sources rather than duplicating them, and link from the docs index.
This was referenced Aug 3, 2026
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.
What
Reviews the reference project srbhr/Resume-Matcher (the closest existing project to Atlas) and folds its applicable patterns into the design, plus adds a
docs/agent/documentation set.docs/PROJECT.mdLLMProviderinterface (new §5.1a). CLI backends (Claude Code/Codex/Antigravity) remain custom subprocess adapters — LiteLLM can't drive them.complete_json()layered structured-output recovery: native field → brace-balancing extraction → content-quality retry with temperature escalation → JSON-mode→prompt-only fallback. Kept distinct from the Router's transport retries.resolve_api_key()with local providers skipping the env-key fallback (§5.1a).docs/agent/Task-oriented docs modeled on the reference's
docs/agent/layout:READMEindex,scope-and-principles,architecture,llm-integration,coding-standards,testing-strategy,workflow. Each points back toAGENTS.md/PROJECT.mdas authoritative rather than duplicating them. Linked from the docs index.Why
Resume-Matcher solves ~Atlas's Phase 1 core loop in a very similar app; adopting its battle-tested AI-robustness patterns de-risks our implementation. Atlas stays a superset (discovery/tracking/calendar/email/daemon + coding-CLI backends).
Testing
Docs-only change. All relative file and anchor links verified to resolve against GitHub's slug algorithm.
Commits (one logical change each)
docs(project): adopt LiteLLM and AI patterns from Resume-Matcher reviewdocs(agent): add docs/agent scaffold for coding agents