aibdd-activity-granularity-rule-docs

Generate declarative Actor and Step granularity rules in Markdown files.

77|15|Updated May 12, 2026
One-click install
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-activity-granularity-rule-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aibdd-activity-granularity-rule-docs
Source: https://github.com/Waterball-Software-Academy/aixbdd/tree/main/.agents/skills/aibdd-skill-granularity-rule
Command: npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-activity-granularity-rule-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you write Activity granularity decision rules that are easy to audit and apply, without accidentally mixing in SOP procedures, execution steps, or upstream trace narratives.

Core Features & Use Cases

  • Rule-only granularity writing: produces declarative invariant entries for Actor/Step granularity that are explicitly “allowed/forbidden/required.”
  • Boundary protection: keeps READ/WRITE/LOAD/DERIVE and other operational instructions out of the rule file, ensuring execution logic stays in SOP.
  • Optional misbehavior guidance: allows a tightly scoped # 反例 with an optional “expected compliant shape” sentence to clarify the judgment boundary.

Use case: When updating or splitting **/rules/*granularity*.md due to a workflow or boundary change, you can provide the decision rules only—so downstream agents don’t get conflicting instructions.

Quick Start

Ask the AI to draft an Actor granularity rule file for your new Activity boundary, enforcing rule-only content and adding a short # 反例 section only when a plausible violation exists.

Frequently Asked Questions about aibdd-activity-granularity-rule-docs

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

FAQPage Schema
How do I write Activity granularity rules without embedding SOP execution procedures?

To write Activity granularity rules without SOP drift, produce declarative invariant entries using testable “can/must/must not” statements, strictly separating decision rules from operational READ/WRITE/LOAD/DERIVE execution logic.

What are granularity decision rules in BDD workflow governance?

Granularity decision rules in BDD workflow governance are boundary-aware invariants for Actor and Step/Action granularity that define what is allowed, forbidden, or required, preventing conflicting instructions for downstream agents.

How do I split granularity rules from discovery content in markdown?

To split granularity rules from discovery content, extract only declarative invariants into a dedicated rule markdown file, ensuring upstream trace narratives and operational instructions remain outside the rule boundary.

When should I include counterexamples in granularity rule files?

Include counterexamples in granularity rule files only when a plausible violation exists, adding a tightly scoped # 反例 section with an optional expected compliant shape sentence to clarify the judgment boundary.

Can I include operational instructions like LOAD and DERIVE in Actor granularity rule files?

No, you must keep READ/WRITE/LOAD/DERIVE and other operational instructions out of Actor granularity rule files to ensure execution logic stays in SOP and downstream agents receive unambiguous decision rules.

What is the best way to enforce spec quality for Activity boundary changes?

To enforce spec quality for Activity boundary changes, update or split the granularity rule markdown files by providing declarative invariants and optional counterexamples, ensuring no SOP-like execution procedures are embedded.