Skip to content

Refine repo context boundaries and GitHub workflow guidance#20

Merged
fqjony merged 11 commits intolatestfrom
feature/dynamic-github-agents
Apr 17, 2026
Merged

Refine repo context boundaries and GitHub workflow guidance#20
fqjony merged 11 commits intolatestfrom
feature/dynamic-github-agents

Conversation

@fqjony
Copy link
Copy Markdown
Contributor

@fqjony fqjony commented Apr 16, 2026

Summary

  • keep .rabbit/context.yaml focused on repo facts, tracing, commands, and gaps instead of mixing in workflow and practice guidance
  • generate AGENTS.md workflow and engineering guidance directly from config catalogs and learned session patterns, with stronger GitHub-first behavior
  • simplify lesson extraction and agent generation around reusable templates, repo-pattern reuse, history-aware debugging, and bot feedback loops
  • rework the docs surface around the new model: simplify the README, add focused docs for installation/context/agents/integration, and remove older overlapping docs
  • clean up install and packaging flow with npm postinstall support and clearer npm-versus-curl ownership
  • remove handled backlog/fixture artifacts that were stale generated output rather than durable repo inputs
  • bump the package to 0.8.0 and document the release in changes.md

Verify

  • bash tests/suite.sh --only core,learn
  • dev.kit repo
  • dev.kit agent

AGENTS.md now generates PR description templates and issue update patterns
dynamically from actual GitHub history via gh api. Learned workflow rules
from session artifacts are injected directly into the workflow section.
Repos with richer history get richer agent guidance — the virtuous cycle.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 16, 2026 14:44
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR enhances dev.kit agent so AGENTS.md can dynamically learn guidance from (1) prior local session lesson artifacts and (2) live GitHub repo/user history, aiming to produce repo-specific PR/issue update guidance on each run.

Changes:

  • Add GitHub PR/issue comment pattern detection utilities (via gh api + jq + awk) to support dynamic guide generation.
  • Inject “Learned from prior sessions”, “PR description guide”, and “Issue update guide” sections into generated AGENTS.md.
  • Extend dev.kit learn flow template rendering to cover additional template IDs; bump version and update changelog.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
package.json Bumps package version to 0.7.0.
lib/modules/learning_sources.sh Adds GitHub-history and lesson-artifact extraction functions used to generate dynamic guides.
lib/commands/agent.sh Writes new dynamic AGENTS.md sections sourced from lessons and GitHub history.
lib/commands/learn.sh Adds missing flow-template cases so templates render with backtick-wrapped labels.
changes.md Documents the 0.7.0 release changes.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread lib/modules/learning_sources.sh Outdated
Comment thread lib/commands/agent.sh
Comment thread lib/commands/agent.sh
Comment thread lib/modules/learning_sources.sh Outdated
fqjony and others added 4 commits April 16, 2026 17:57
…cation

- Pass sample_size through to jq instead of hard-coded .[:8] slice
- Update AGENTS.md header to reflect all three sources
- Cap best-example bodies at 60 lines to limit exposure

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 16, 2026 17:15
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 26 out of 28 changed files in this pull request and generated 4 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .rabbit/context.yaml Outdated
Comment thread AGENTS.md Outdated
Comment thread .rabbit/dev.kit/lessons-dev.kit-2026-04-15.md Outdated
Comment thread lib/commands/learn.sh
Copilot AI review requested due to automatic review settings April 17, 2026 17:56
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 38 out of 40 changed files in this pull request and generated 4 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread tests/suite.sh
Comment thread lib/commands/agent.sh
@fqjony fqjony changed the title Add dynamic GitHub guides and lesson injection to AGENTS.md Refine repo context boundaries and GitHub workflow guidance Apr 17, 2026
@fqjony fqjony requested review from a team and udx-github April 17, 2026 18:22
@fqjony fqjony self-assigned this Apr 17, 2026
Copilot AI review requested due to automatic review settings April 17, 2026 18:23
udx-github
udx-github previously approved these changes Apr 17, 2026
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 41 out of 43 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

lib/commands/agent.sh:180

  • The header comment above dev_kit_agent_write_agents_md says “All content is derived from context.yaml”, but the function now also injects workflow/practices from config catalogs plus GitHub history and lesson artifacts. Update the comment to match the actual inputs so maintainers don’t accidentally break the non-context dependencies.
# Write AGENTS.md — the repo's execution contract for AI agents.
# All content is derived from context.yaml. Agents operate from this file,
# not from filesystem discovery.
dev_kit_agent_write_agents_md() {

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread AGENTS.md
Comment thread package.json Outdated
@fqjony fqjony merged commit 4b84821 into latest Apr 17, 2026
9 checks passed
@fqjony fqjony deleted the feature/dynamic-github-agents branch April 17, 2026 18:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants