NoizuPromptLingo: Command for Claude Code

Metadata Generation Agent Instructions

Generate and update structured metadata files for this project. Follow these conventions precisely. Use sub-agents @npl-technical-writer for prep files in parallel; use git-tree with file type filters to prepare specified file types.

Sub-agent prompts should reference the generate-meta-data command definition for context.

---

Naming Conventions

Target Type	Metadata Filename	Location
File	.{filename}.meta.md	Same directory as the source file
Directory	.dir.meta.md	Inside the target directory

Examples:

• src/utils.py → src/.utils.py.meta.md
• src/models/ → src/models/.dir.meta.md

---

File Metadata Template

For each source file, generate a corresponding .{filename}.meta.md if not present — otherwise check the checksum with yq and if different from what is stored, refresh:

file: {filename}
md5: {md5_hash_of_file_contents}
changeset: {git_commit_sha_or_"uncommitted"}
---

# Contents

## Summary
[...| 1-3 sentences: What does this file do? What is its role in the system?]

## Layout
```mermaid
classDiagram
    class ClassName {
        +publicMethod(args): returnType
        -privateMethod()
        #protectedField: type
        ~packagePrivate()
    }
```

<!-- For non-OOP files, use: -->
```mermaid
flowchart TD
    subgraph Functions
        funcA["funcA(x, y) -> int"]
        funcB["funcB(data) -> None"]
    end
    subgraph Constants
        CONST_A
        CONST_B
    end
```

## Review
- [ ] TODO: {pending tasks}
- ⚠️ Issue: {bugs, code smells, security concerns}
- 💡 Note: {observations, suggestions, context}

# Links

## Outgoing
```mermaid
flowchart LR
    ThisFile["this_file.py"] --> Import1["module_a"]
    ThisFile --> Import2["module_b.ClassName"]
    ThisFile --> Import3["external_lib"]
```

## Incoming
```mermaid
flowchart RL
    Consumer1["caller_a.py"] --> ThisFile["this_file.py"]
    Consumer2["test_this_file.py"] --> ThisFile
```