cuioss/plan-marshall-plugin

Plan Marshall Plugin - Build Discovery

Enforcement

Execution mode: Reference module — loaded by extension-api for build system discovery.

Prohibited actions:

• Do not call discovery scripts directly; use extension-api commands instead
• Do not modify discovery delegation order
• Do not alter build system marker detection logic without updating all delegated scripts

Constraints:

• Module discovery is read-only — no file system mutations
• Results are consumed by manage-architecture and marshall-steward
• All discovery invocations flow through the extension-api entry point

Consolidates module discovery for all build systems (Maven, Gradle, npm, Python) into a single extension point. Also provides the general-dev domain with cross-cutting development skills. Build execution scripts live in sibling skill directories (build-maven, build-gradle, build-npm, build-pyproject).

See extension-contract.md for the complete ExtensionBase contract.

Extension API

| Function | Purpose | |----------|---------| | get_skill_domains() | Returns build domain (empty profiles) + general-dev domain (cross-cutting dev skills) | | discover_modules(project_root) | Discover modules across Maven, Gradle, npm, and Python | | provides_recipes() | Returns the code-review, refactor-to-profile-standards, security-audit, and agentfile-hygiene recipes | | applies_to_module(module_data) | Applies general-dev skills to modules with code build systems |

Discovery Flow

The extension scans the project root for build system markers:

| Marker File | Build System | |-------------|-------------| | pom.xml | Maven | | build.gradle / build.gradle.kts | Gradle | | package.json | npm | | pyproject.toml | Python (pyprojectx) |

Each detected build system delegates to its corresponding discovery script. Results from all build systems are collected and, when multiple build systems coexist at the same path, split into separate virtual modules with technology suffixes (e.g., my-module-maven, my-module-npm).

Discovery Delegation

• Maven: build-maven/scripts/_maven_cmd_discover.py
• Gradle: build-gradle/scripts/_gradle_cmd_discover.py
• npm: build-npm/scripts/_npm_cmd_discover.py
• Python: build-pyproject/scripts/_pyproject_cmd_discover.py