Repository navigation
Add repo-specific repo assist map, MCP baseline verification, and project skills - #127
Conversation
|
Important Review skippedBot user detected. To trigger a single review, invoke the
|
Co-authored-by: groupthinking <154503486+groupthinking@users.noreply.github.com>
Co-authored-by: groupthinking <154503486+groupthinking@users.noreply.github.com>
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Portability and MCP verification documentation issues remain unresolved.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 5
Open (5)
What changed in this PR
Adds repo-specific agent guidance, MCP verification documentation, project skills, README wiring, and guardrail tests.
Changes:
- Adds repository mapping and MCP guidance.
- Adds CI-debugging and codebase-summary skills.
- Links documentation from
README.md. - Adds tests validating the new materials.
| File | Description |
|---|---|
tests/test_repo_assist_docs.py |
Guardrail checks for documentation and skills |
README.md |
Links to the repository map |
docs/REPO_MAP.md |
Documents structure, dependencies, workflows, and MCP verification |
.github/skills/github-actions-failure-debugging/SKILL.md |
Adds CI debugging guidance |
.github/skills/codebase-summary/SKILL.md |
Adds repository summarization guidance |
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
groupthinking
left a comment
There was a problem hiding this comment.
Reviewed the repaired current head 18057fe078d060b43f758a1031156c18d1f25f9b. The 3 remaining inline findings are addressed in the code and repository guidance. The exact CI pytest command passes with 31 tests and 3 explicit integration skips on both Python versions; all current hosted jobs have finished with 7 successes and only CodeRabbit skipped. The previously masked pytest failure is now blocking.
Approval covers this repository-guidance and CI change. MCP verification is in-process only; live QPU/provider/transport behavior is untested. Existing advisory flake8 and incomplete coverage are disclosed in the updated description. #126 and #127 are competing proposals for #125, so this approval does not authorize merging both or merging either automatically.

Summary
Adds a repository map, an architecture diagram tied to actual imports, an agent-workflow checklist, and two repository-specific skills: codebase-summary and github-actions-failure-debugging. The README and project skills use repository-relative links and discover the current checkout root. The MCP verifier asserts successful responses and expected capabilities/tool output, so handler errors fail the command instead of merely being printed.
The MCP checks exercise the existing custom JSON-RPC handler in-process. They verify the documented initialization, tool discovery/execution and error behavior; they do not establish external transport compatibility or complete MCP specification compliance.
Code and CI repairs
pythonpath = .so the exact console command used by GitHub collects the repository packages.Validation
Current tested head:
18057fe078d060b43f758a1031156c18d1f25f9b.pytest --cov=.: 31 passed and 3 explicit integration skips on both Python 3.10 and 3.11, withPYTHONPATHandDWAVE_API_TOKENunset.black --check .: passed on both versions.The three integration skips require quantum configuration, a D-Wave token or an external local MCP service. No live QPU, provider or external MCP transport success is claimed. The existing flake8 step remains advisory, and a pre-existing coverage-parser warning limits coverage completeness; the passing jobs do not establish a lint-clean repository or complete coverage.
This addresses #125. PRs #126 and #127 are parallel proposals for that issue; this review does not choose or merge both alternatives.