proceed-and-document

Name: proceed-and-document
Availability: InStock
Author: sparq-org

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

Ready to run

npx skills add https://github.com/sparq-org/sparq --skill proceed-and-document

💬 Prompt for ChatGPT / Claude Chat▼

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.