Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 49 additions & 2 deletions .agents/skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,60 @@
This directory contains repo-local copies of canonical skills from
`The-Interdependency/skill-lib`.

Source commit: `c14ee9d500579a4b5d6821f62c9d82ca96e73608`
Source commit: `38c64332b840b2bbe1c07e53aeee8996644548e9`

Repo-local copies are not the source of truth. Edit `skill-lib` first,
then propagate from the canonical source.

Installed skills:
Skills refreshed from the source commit above:

- `meta-module-build/`
- `msdmd/`
- `test-build/`

Other installed skills (not refreshed by this propagation):

Their existing files retain their own authority/provenance; the source
commit above does not assert that these copies were refreshed.

- `a0-deep-research/`
- `a0-file-converter/`
- `a0-github-solution-finder/`
- `a0-infographic-builder/`
- `a0-website-design/`
- `a0p-fleet-runs/`
- `a0p-model-selector/`
- `a0p-module-doctrine/`
- `a0p-pcea-naming/`
- `a0p-self-declaring-modules/`
- `a0p-troubleshooter/`
- `agent-tools/`
- `anthropic-api/`
- `audit-website/`
- `better-auth-best-practices/`
- `brainstorming/`
- `browser-use/`
- `build-website/`
- `clean-build/`
- `distill-construction/`
- `distill-engineering/`
- `distill-general/`
- `distill-law/`
- `distill-medicine/`
- `find-skills/`
- `frontend-design/`
- `gemini-api/`
- `github-pages-management/`
- `gpt-5-api/`
- `grok-api/`
- `hmmm-disclosure/`
- `multimodel-handoff/`
- `next-best-practices/`
- `refuse-task/`
- `skill-creator/`
- `tool-use/`
- `ui-ux-pro-max/`
- `vercel-composition-patterns/`
- `vercel-react-best-practices/`
- `vercel-react-native-skills/`
- `web-design-guidelines/`
63 changes: 48 additions & 15 deletions .agents/skills/meta-module-build/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,21 @@
---
name: meta-module-build
description: Metadata-first module build skill built on msdmd. Use this when turning a capability idea into a bounded module manifest, file plan, public/internal surface, permission boundary, tests, docs, rollout, and rollback notes before implementation.
description: Native-first module planning built on msdmd. Consume existing manifests, schemas and design declarations; supplemental MODULE_BUILD blocks record remaining purpose, surface, boundary, test, rollout and rollback obligations. Load this when turning a capability idea into a bounded module manifest and file plan before implementation.
---

GPT generated; context, prompt Erin Spencer

# meta-module-build — Metadata-first module scaffolding

`meta-module-build` is an application of [msdmd](../msdmd/SKILL.md). It uses self-declared metadata to keep a proposed module's purpose, surfaces, dependencies, boundaries, tests, and rollout notes visible beside the files that implement it.
GPT generated; context, prompt Erin Spencer

Read `msdmd/SKILL.md` first. This skill inherits the block syntax, parser contract, and visible gap-reporting requirement.
`meta-module-build` is an application of [msdmd](../msdmd/SKILL.md). It
keeps proposed purpose, surfaces, dependencies, boundaries, tests and rollout
notes attributable to the sources that own them.

Read `msdmd/SKILL.md` first. This skill inherits its source/provenance, native
reader support, supplemental block and information-coverage contracts.
Implementation status: this is a consuming-repo planning/runner contract. The
MSDMD schema-2 collector preserves JSON and TOML manifest trees, but this repo
does not ship a complete MODULE_BUILD obligation/policy runner.

## Doctrine

Expand All @@ -21,9 +27,21 @@ intent -> manifest -> file plan -> tests -> scaffold -> reviewable change

If a field is not known, write `hmmm`. Do not guess certainty into the manifest.

## Native-first coverage

Consume existing package/module manifests, schemas, source-owned design
records and explicit rollout/test declarations before requesting supplemental
metadata. Preserve owning scope and source references. A package manifest is
not automatically a module plan: map only information it actually expresses.

The build's semantic obligations remain required, but their native owners need
no MODULE_BUILD copies. Supplement genuinely unexpressed intent. Unsupported
mapping is unresolved coverage, not absence. Semantic planning mappings beyond
the shipped structured-source preservation remain implementation work.

## The block

A module owns its build declaration in a `MODULE_BUILD` block:
A module may supplement its build declaration with a `MODULE_BUILD` block:

```python
# === MODULE_BUILD ===
Expand All @@ -47,7 +65,9 @@ A module owns its build declaration in a `MODULE_BUILD` block:

## Field schema

Required:
This syntax governs supplemental MODULE_BUILD entries. Native sources retain
their own schemas and must satisfy the applicable planning obligations without
invented IDs or copied fields. Required for a supplemental entry:

| Field | Meaning |
|---|---|
Expand All @@ -62,7 +82,7 @@ Required:
| `rollout` | How the module becomes active. |
| `rollback` | How to disable or remove it cleanly. |

Boundary fields are required because module generation often crosses hidden lines:
Boundary information is required because module generation often crosses hidden lines:

| Field | Meaning |
|---|---|
Expand Down Expand Up @@ -139,21 +159,31 @@ Do not use raw factorization sentinels for A0-facing claims when a scoped envelo

A `MODULE_BUILD` runner should:

1. parse all `MODULE_BUILD` blocks using the msdmd universal parser;
2. validate required fields;
3. report boundary fields visibly;
4. report modules without `MODULE_BUILD` as coverage gaps;
5. optionally fail in strict mode when required build metadata is missing;
1. extract supported native planning metadata and parse supplemental
`MODULE_BUILD` blocks using the msdmd universal parser;
2. validate native mappings and supplemental fields under their own schemas;
3. report boundary information and its owning sources visibly;
4. report genuinely absent required planning information only after capable
inspection; keep missing blocks separate as adoption observations;
5. fail strict mode on missing information, required unsupported extraction or
unresolved conflicts, rather than accepting incomplete coverage;
6. emit a review summary grouped by `module_kind` and boundary risk.

## Validation

A supported native planning fixture must satisfy the information it actually
expresses without a MODULE_BUILD copy. Include missing rollback, unresolved
boundary, unsupported mapping and same-name/different-scope cases.

## Anti-patterns

- Building code first and writing the manifest after.
- Omitting boundary fields because the module feels small.
- Omitting boundary information because the module feels small.
- Marking unknowns as solved instead of `hmmm`.
- Using implementation-shaped ids that do not explain the protected capability.
- Adding UI or route behavior without declaring metadata expectations.
- Treating frontier-domain UCNS results as absolute claims.
- Demanding a second MODULE_BUILD copy of already-owned native information.

## Completion criteria

Expand All @@ -169,10 +199,13 @@ or
scaffold PR with tests and docs
```

It is incomplete if it only produces an idea, a patch with no manifest, or a module with no boundary/test plan.
The manifest may be composed from source-linked native declarations and
supplemental entries. An idea alone, a patch with no manifest, or a module with
no boundary/test plan remains incomplete.

## hmmm

Native planning-obligation mappings remain consuming-repo implementation work.
Default unresolved items for new modules:

```text
Expand Down
Loading
Loading