Add repo-specific repo assist map, MCP baseline verification, and project skills

[Copilot]

Pull Request

Description

Adds repo-specific guidance for agent runs in self-correcting-executor: a current repo map, dependency snapshot, MCP host/client/server framing, and a minimal live capability-negotiation proof. Also adds two project-scoped skills so CI debugging and repo summarization use this repo’s actual structure and workflows instead of generic examples.

• Repo assist doc

  • adds docs/REPO_MAP.md with:
    • focused tree map
    • mermaid architecture diagram
    • dependency summary from Python/CI/frontend manifests
    • agentic workflow checklist
    • MCP usage assessment and host/client/server mapping
    • live verification sequence for initialize, tools/list, and tools/call
    • CI baseline note calling out masked flake8 / pytest failures in current workflow behavior

• Project skills

  • adds .github/skills/github-actions-failure-debugging/SKILL.md
    • tailored to python-ci.yml and frontend-ci.yml
    • routes investigation through GitHub MCP workflow runs + job logs first
  • adds .github/skills/codebase-summary/SKILL.md
    • standardizes repo mapping, dependency review, and MCP baseline verification for this codebase

• Documentation wiring

  • updates README.md to point to the repo assist document

• Guardrail test

  • adds tests/test_repo_assist_docs.py to assert the new repo map sections and project skills remain present and repo-specific

from mcp_server.main import MCPServer

server = MCPServer()
await server.handle_request({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {"clientInfo": {"name": "repo-assist", "version": "1.0"}},
})

Type of change

• Bug fix
• New feature
• Breaking change
• Documentation update
• Other (describe): project-scoped Copilot skills and focused documentation guardrail test

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published in downstream modules

Screenshots (if applicable)

Additional context

The issue asked for repo-specific examples, at least two useful skills, and proof that baseline MCP negotiation works live for this repo. The new materials are intentionally scoped to the existing repository layout and workflows rather than introducing new runtime behavior.

• Fixes REPO UPDATE-> follow steps prove verification on implementation by running it live. #125

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository: groupthinking/self-correcting-executor/.coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 2d170dfd-c63f-4f00-8626-df41a286da07

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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.}

[Copilot]

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)

• Use repository-relative paths instead of hosted runner paths · New
• Resolve the repository root dynamically · New
• Use a portable repository-relative README link · New
• Use portable repository-relative server paths · New
• Assert successful results during MCP verification · New

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.