Repository navigation
Agent tooling - #21
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
The constraint-component guide contains unresolved correctness issues, alongside documentation consistency and formatting fixes.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 2
Open (2)
What changed in this PR
Introduces a shared agent-instruction framework with synchronization tooling and task-specific guides.
Changes:
- Adds canonical guidance for Codex, Copilot, and Claude.
- Adds synchronization and maintenance documentation.
- Adds task-guide indexing, templates, and a constraint-component guide.
| File | Description |
|---|---|
scripts/sync_agent_instructions.py |
Synchronizes instruction files |
README.md |
Links agent documentation |
docs/agent-tasks/TEMPLATE.md |
Task-guide authoring template |
docs/agent-tasks/index.md |
Task-guide index |
docs/agent-tasks/add-constraint-component.md |
Constraint implementation workflow |
docs/agent-instructions.md |
Maintenance documentation |
CLAUDE.md |
Imports canonical guidance |
AGENTS.md |
Canonical agent guidance |
.github/copilot-instructions.md |
Generated Copilot guidance |
.agents/skills/add-constraint-component/SKILL.md |
Native task discovery wrapper |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
+157
to
+159
| Update applicable single-process and multiprocess model sequences and partition dependencies. | ||
| Implement downstream consumption only to the extent agreed in the contract; otherwise document the | ||
| intended future consumers and that the attribute currently has no such effect. |
Added reminder to check dependency sources in pyproject.toml before making changes. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This was referenced Sep 23, 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
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.
This pull request introduces a comprehensive framework for maintaining and distributing shared coding-agent instructions across the Lighthouse repository. It establishes a canonical baseline for agent guidance, ensures synchronization with Copilot and Claude, and provides a structure for adding and discovering task-specific guides. The changes include new documentation, scripts, and templates to support agent instruction management and task routing.
Agent instruction framework and synchronization:
AGENTS.md, detailing repository context, coding practices, validation, and task-specific guide usage..github/copilot-instructions.mdas a generated copy of the baseline for Copilot compatibility, with instructions and a script (scripts/sync_agent_instructions.py) to keep it in sync. [1] [2]CLAUDE.mdto import the canonical baseline using@AGENTS.mdfor Claude agent compatibility.docs/agent-instructions.mdto document the maintenance process, synchronization workflow, and compatibility considerations for agent instructions.Task guide structure and discovery:
docs/agent-tasks/index.mdas a central index for specialized task guides, and included a template (docs/agent-tasks/TEMPLATE.md) for authoring new guides. [1] [2].agents/skills/add-constraint-component/SKILL.mdand linked documentation), with clear triggers, exclusions, and discovery via native agent skills. [1] [2]Repository documentation updates:
README.mdto reference the new agent instruction framework and maintenance documentation.