skills.rest
sparq-org
sparq-orgOFFICIAL
Explore all skills by this author →
GitHub

proceed-and-document

Document sparq agent decisions and open GitHub issues for maintainer review.

8|1|Updated Jun 7, 2026
Search Tags:#github#issue tracking#decision-making#agent automation#sparq
One-click install
npx skills add https://github.com/sparq-org/sparq --skill proceed-and-document
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: proceed-and-document
Source: https://github.com/sparq-org/sparq/tree/main/.claude/skills/proceed-and-document
Command: npx skills add https://github.com/sparq-org/sparq --skill proceed-and-document

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the decision-making and documentation process for sparq agents, allowing them to proceed with judgments and decisions without immediate maintainer approval while ensuring proper documentation for future reference.

Core Features & Use Cases

  • Automated Decision Making: The Skill enables sparq agents to make and document decisions autonomously when faced with judgment calls or design choices.
  • Documentation: Ensures all decisions are documented with a PR note, a bead note, and a GitHub issue for maintainers to review later.
  • Use Case: Sparq agents can now proceed with decisions related to design greenlight or naming choices, with all necessary documentation created automatically.

Quick Start

Use the proceed-and-document skill to document a decision made in the current task.

Frequently Asked Questions about proceed-and-document

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate agent decision-making and documentation on GitHub?▼

To automate decision-making and documentation, you can use this Skill to let sparq agents autonomously make design judgments while automatically generating PR notes, bead notes, and GitHub issues for maintainer review.

What is the process for tracking autonomous agent decisions in GitHub issues?▼

Tracking autonomous agent decisions involves automatically opening a GitHub issue with the relevant PR and bead notes attached, allowing maintainers to review judgments made by sparq agents during a task asynchronously.

Can sparq agents proceed with design choices without immediate maintainer approval?▼

Yes, sparq agents can proceed with design greenlight or naming choices without immediate approval by using this Skill to document the decision and open a GitHub issue for subsequent maintainer oversight.

How do I document decisions made by automated agents for later review?▼

Documenting decisions made by automated agents requires generating a structured record containing a PR note, a bead note, and a GitHub issue, ensuring all autonomous judgments are traceable for future reference.

What are the limitations of autonomous decision documentation for sparq agents?▼

The autonomous decision documentation applies specifically to sparq agents facing design choices or judgment calls, and relies on GitHub issues for maintainer oversight rather than providing real-time approval gating.

Related Skills

Explore More Software Engineering Skills→
rotnovrotnov

issue-select

Select the next GitHub issue by inventorying open tasks against repository state.

Community
Advanced
VMRam95VMRam95

review-pr

Reviews pull requests for architectural, security, and quality issues.

Community
Advanced
robertolopezlopezrobertolopezlopez
1

github-pr-comment-analysis

Group unresolved GitHub pull request comments into actionable issue sections.

Community
Advanced
dandacompanydandacompany
22

bk-approve

Inspect pending approval steps and collect user decisions in AI workflows.

Community
Intermediate