feat(outfitter skill): proactive agentic-design advisor - #204
Open
ncrmro wants to merge 6 commits into
Open
Conversation
…nd automation surfaces Restructure the documentation entry points around a progressive journey (start personal → understand → grow → automate → contribute): - README: replace the stale legacy-profile status banner with the protocol pin, open with the force-multiplier why (the ladder and the surfaces), and link the philosophy and the journey index. - docs index: tiered journey with a stated progressive-disclosure IA. - conventions.md (new): place once, specialize downward, never copy; layer homes; ambient rule vs skill vs hook placement. - recurring-runs.md (new): loops three ways — local loop extension, Actions cron, cluster CronJobs/resident — one primitive, three clocks. - in-cluster.md (new): Link Operator primitives, execution shapes, channels. - subagents.md: the four delegation boundaries plus adversarial-review and singleton-coordinator patterns. - usecases (new, story-first): shared-conventions dedup, flaky-test post-mortems, grafana-alert-investigator, self-improving-skills. Refs #197 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… fragment Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…e referenced Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…atus labels, adapter caveats - Correct override semantics everywhere they were overstated: ID-addressed resources merge by ID; root agents.md/system-prompt.md wins whole-file by layer precedence, with fragment-level override deferred to the conventions roadmap primitive. - Restore a transition note (published CLI may lag these docs; Migration linked) and a surfaces-status caveat in the README. - Label project-repos as an illustrative convention, not shipped catalog behavior; describe Claude porting/symlinks as the design tracked in #187. - Reframe recurring runs as one composition/contract with different clocks and lifecycles; note the loop extension is loadout-selected, not bundled. - Qualify CI transcript artifacts as optional and adapter-dependent. - Mark the Link Operator page as a design preview (not yet public), drop dead links, and fix the delegation-boundary ordinal. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Semantic node ids throughout, self-closing <br/>, quoted labels, autonumber on the run sequence, and labeled graduation edges on the README ladder. Skill: ai-outfitter/community-profiles#9. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Grow the always-on `outfitter` self-skill from a reactive doc router into a proactive advisor that recognizes which agentic-design patterns fit a user's project and applies them — so a non-expert gets good agentic design. - Description + intro reframed to an advisor posture (proactive, not noisy). - New "Agentic patterns" section: project-signal → pattern → reference → apply (CI issue-triage, recurring-runs graduation ladder, channel intake, in-cluster residency, few-agents-many-skills, subagent delegation, ambient conventions, org adoption). - New "Audit a project" section: survey signals, match patterns, present a prioritized shortlist, offer to apply. - Operational apply surface: beyond `outfitter`, drive `gh` (workflow PRs) and `kubectl` (Organization/Agent CRs), with a guard — validate first, confirm before any outward/irreversible action. - References + routing extended with conventions, recurring-runs, in-cluster, channels, and the organization-profile-catalog usecase. Includes docs/documentation/channels.md so the channels pattern resolves; stacks on the post-v1-revamp docs. outfitter validate --strict passes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.
Grows the always-on
outfitterself-skill from a reactive documentation router into a proactive agentic-design advisor: it recognizes which of the ecosystem's patterns fit a user's project and applies them with Outfitter's primitives — so a non-expert gets good agentic design.What changed (
.outfitter/skills/outfitter/SKILL.md)## Agentic patterns— a project-signal → pattern → reference → apply map: CI issue-triage (actions), the recurring-runs graduation ladder, channel intake (channels), in-cluster residency (operator), few-agents-many-skills / skill-as-router, subagent delegation, ambient conventions, and org adoption (control catalog).## Audit a project— survey signals (repo type,.agents, CI, k8s, channels/creds, goal) → match → prioritized shortlist → offer to apply.outfitterCLI, drivegh(workflow PRs) andkubectl(Organization/AgentCRs), with a guard:outfitter validate --strict+ drydump/runfirst, and confirm before any outward/irreversible action.conventions,recurring-runs,in-cluster,channels,usecases/organization-profile-catalog.No new skill, no separate pattern library — the patterns are the docs the skill already ships.
outfitter validate --strictpasses.Dependencies
docs/post-v1-revamp(needs itsconventions/recurring-runs/in-clusterdocs). Retarget tomainonce that lands.docs/documentation/channels.md(same content as the channels-docs PR); if that merges first, this reconciles trivially.🤖 Generated with Claude Code