Index of every page on this site: llms.txt
All skills
a2ui-project avatar

/a2ui-blueprint-compliance

@6bf4cc2
by A2UIa2ui-project/a2ui18k stars
1,430
Run it yourself

Verification of platform codebase blueprint compliance against the latest module blueprints.

  • 3 files
  • 31.7 KB
  • Updated 2 weeks ago
  • GitHub
Use this Skill: https://skilld.dev/gh/a2ui-project/a2ui/a2ui-blueprint-compliance

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈30 tokens for metadata: the name and description. ≈954 when used: this file.

Description uses 1.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈120 characters, or 1.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

A2UI Blueprint Compliance Check Skill

This skill guides you through the process of auditing the repository's codebase blueprints to verify that they are synchronized with the latest module specifications, and posting a weekly report issue.


Instructions

[!IMPORTANT] All codebase auditing must be performed using static/structural inspection (e.g. reading file contents, grep searching symbols, checking git logs, or static lints). Do not run package/dependency installations (like yarn install, pip install, pub get), compile code, or execute dynamic test suites.

  1. Run Check Compliance Script:

    • Run the compliance checker script to generate the baseline status of the repository:
      python3 blueprints/skills/a2ui-blueprint-compliance/scripts/check_compliance.py
    • This script automatically discovers codebase blueprints, parses their pinned commits, compares them against module blueprints git logs, and formats the baseline Markdown report structure.
  2. Audit Each Codebase (Manual Verification):

    • For each codebase, perform the following static code analysis tasks:

      • Step 2.1: Audit Actual Implementation vs. Module Blueprint:
        • Analyze the specifications, required interfaces, and behavior described in the module blueprint (located at blueprints/modules/<associated_module>.blueprint.md).
        • Inspect the source code in the codebase directory (<codebase_path>) to verify if the required specifications are implemented.
        • Identify any features, interfaces, or protocol requirements specified in the module blueprint (including those introduced in the missing commits listed in the script's output report) that are not currently implemented in the code.
    • Step 2.2: Audit Claimed Features (implemented_features):

      • For each feature key and pinned commit hash in the codebase blueprint's implemented_features mapping ({feature_name: <commit_sha>}):
        • Verify that the pinned commit matches the latest commit on blueprints/features/<feature_name>.blueprint.md (or inspect git diff <pinned_sha>..HEAD -- blueprints/features/<feature_name>.blueprint.md).
        • Search the codebase (code files, symbols, tests, or documentation) to verify if the feature is actually implemented.
        • If it is not found or is incomplete, flag it as a discrepancy (e.g. "Claimed as implemented, but missing or incomplete in code").
    • Step 2.3: Identify Implemented Optional Features:

      • Inspect the codebase for any implemented optional features (either from the blueprints/features/ folder, or from codebase-specific extensions).
      • Verify if they are correctly documented in the codebase blueprint's implemented_features.
      • Compile a list of verified implemented optional features.
  3. Format the Report:

    • Build a Markdown report with a summary table listing:
      • Codebase Path
      • Associated Module
      • Status (Up to Date, Out of Date, Not Baselined, Error)
      • Commits Behind
      • Pinned Commit
      • Latest Commit
    • For each codebase, include a detailed section listing:
      • Missing Required Features: Features/specifications in the module blueprint (or in newer commits to it) that are missing from the implementation code.
      • Feature Claims Verification / Discrepancies:
        • Features listed in implemented_features that are missing or incomplete in the code.
        • Implemented features that are missing from the implemented_features frontmatter list.
      • Implemented Optional Features: A list of optional features verified as implemented in the code.
      • Missing Commits / Spec Diffs: The list of git commits since the pinned hash.
    • Return this Markdown report as your final response.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 6bf4cc2. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago
metadata
{
  "internal": true
}

README badge

README badge for a2ui-project/a2ui/a2ui-blueprint-compliance