grill-with-docs

Featured

Grill a fuzzy, single-session repository change into shared language, recorded decisions, and a handoff-ready plan. Use when the operator asks to grill or stress-test a plan or design in a repository; route multi-session uncertainty to wayfinder.

AI & Automation 175 stars 6 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
75
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Grill with docs Resolve a change's design tree with the operator while recording each answer where a fresh session can use it. Stop at a handoff-ready plan; implementation is a separate unit of work. ## Route - Use this workflow when a repository change is fuzzy but can be settled in one session. - Use `wayfinder` when the destination spans sessions, has dependent decisions that need separate research, or cannot yet become one implementation plan. - Use the ordinary plan flow when scope, language, and consequential choices are already settled. ## Establish the tree 1. Read the tracked item, existing plan/spec, `CONTEXT-MAP.md`, relevant `CONTEXT.md` files, ADRs, and the code or assets that constrain the change. Facts come from the repository; decisions come from the operator. 2. Locate the project's plan convention. Reuse an existing change plan; otherwise create one from `.harness/templates/plan.md`, `templates/plan.md`, or the same shape at `.planning/<slug>.md`, in that order of availability. 3. Map the unresolved choices as a design tree. Its **frontier** is the independent questions whose prerequisites are settled now. ## Work the frontier Ask a small numbered round from the frontier. For each question, state why it matters, the real options and trade-offs, and your recommended answer. Then wait for the operator's decisions. After each answer round: 1. Recompute the tree. Cross-check claims against the repository and surface contradictions. 2. Re...

Details

Author
PromptPartner
Repository
PromptPartner/agentsmith
Created
2 months ago
Last Updated
2 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category