Repository navigation
v0.2.4 - ARPA Skillware Mnemonic Matrix, 3 Curated Personas, Modular AI Wizard Prompts & Automated Labels Sync
LatestMnemoLink v0.2.4 introduces the ARPA Skillware Mnemonic Matrix, three distinct curated personas (bladez, bald_accountant, kpop_celeb), modularized AI Wizard system instructions with few-shot exemplars across archetypes, robust automated GitHub label synchronization, and an expanded 112-test suite verified with 100% offline isolation.
Key Highlights in v0.2.4
1. ARPA Skillware Mnemonic Matrix Integration (docs/integrations/skillware_matrix.md)
Establishes the flagship integration between sister frameworks ARPA Skillware (v0.5.5, Motor Cortex) and MnemoLink (Epistemic Cortex), solving the native Skillware context dilemma:
- Directives Mode Bloat vs. Brief Mode Blindness: Raw
directivesdumps 6,000–15,000+ tokens of instruction markdown in multi-skill workflows, causing attention dilution and high inference bills. Conversely, rawbriefmode strips edge cases (~25 tokens/skill), leading to unconfirmed state mutations, stripped leading zeros (08472910->8472910), and unhandled HTTP 429 errors. - Persona
skillware_operator(tool_governance): Invariant cached system prefix enforcing the four-stage execution discipline: resolve -> draft -> preview -> confirm. - 4 Curated
skillware/Category Memories:skillware/interactive_slot_filling(work): Conversational slot gathering, preview rendering, and confirmation gates.skillware/entity_disambiguation(work): Candidate formatting and leading-zero preservation for UK Companies House registry numbers.skillware/irreversible_action_crucible(incident): The $48.2k burn postmortem enforcing EIP-55 checksums, slippage caps, and two-phase simulation.skillware/runtime_outage_and_grace(relational): Calmly shields raw HTTP 429/503 stack traces with polite backoff and user reassurance.
- Lineage
skillware_execution_mastery: 4-epoch progression linking slot-filling through registry handling, financial custody, and outage resilience. - Empirical Simulation Suite (
scripts/simulate_skillware_matrix.py): Evaluates 5 multi-turn production scenarios. By pairing lean tool briefs with targeted JIT lessons chunks, agents achieve 100% safety compliance while cutting prompt overhead by 50.5% to 84.0% and reducing turn inference costs by over 95% via prefix caching. - Hermetic Offline CI: Bundled
scripts/skillware_directives.jsonguaranteeing 100% offline reproducibility across all test environments without external repo clones.
2. Three Distinct Curated Personas (bladez, bald_accountant, kpop_celeb)
Expands the foundational personas library with three detailed, battle-tested archetypes:
bladez(Tactical Security Operator): Wesley Snipes/Blade attitude—dark, no-nonsense, laconic, razor wit, hyper-observant threat neutralization, and kinetic perimeter defense. Includes manifest (persona.yaml), teleological card (card.json), and guide (docs/personas/bladez.md).bald_accountant(Shadow Family Accountant): 1970s shadowy family fund accountant—smoky wood-paneled office, rotary phone, double-entry ledger choreography, cross-border jurisdictional insulation, Panamanian trusts, and fiduciary omerta. Includes manifest (persona.yaml), teleological card (card.json), and guide (docs/personas/bald_accountant.md).kpop_celeb(Viral K-Pop Celebrity): High-energy Gen Z viral K-pop icon—livestream powerhouse, master of audience retention hooks, chaotic community banter, Gen Z internet slang, and passionate fandom mobilization. Includes manifest (persona.yaml), teleological card (card.json), and guide (docs/personas/kpop_celeb.md).
3. Dedicated Modular AI Wizard System Instructions (mnemolink/wizard_prompts.py)
- Extracted and modularized system prompts for Personas, Memories, and Lineages into dedicated prompt builders.
- Intelligent Gap-Filling Protocol: Teaches models how to analyze brief, fragmented user seeds, infer the operational domain, and extrapolate authentic epistemological stances, sensory context, and principles without hardcoded constraints.
- Multi-Archetype Few-Shot Demonstrations: Embedded transformation exemplars covering artisan craft (master baker), operational sentinels (SRE commander), and scholarly mentors (admiralty jurist).
- Taxonomy Alignment: Full alignment across all 5 memory kinds (
lore,work,incident,relational,telemetry), enforcing concrete financial/equipment damage strictly onincidentmemories.
4. Automated GitHub Label Synchronization (scripts/sync_labels.py)
- Robust Python automation for bidirectional GitHub label synchronization across the entire repository taxonomy (priorities, domains, issue types, mnemonic types).
- Hardened GitHub REST API headers with explicit
Content-Type: application/jsonand API version pinning (2022-11-28). - Pre-flight pagination queries to perform differential updates, avoiding redundant PATCH requests and secondary API rate limits.
- Added workflow
.github/workflows/labels.ymlwith PR dry-run validation alongside automated synchronization on push tomainand manual dispatch.
5. Expanded Unit & Integration Test Suite (112 Passing Tests)
- Expanded test coverage from 93 to 112 passing tests in < 5.5s:
tests/test_skillware_bench.py(6 tests): Skillware operator persona, 4 memories, chained lineage, offline simulation execution, multi-memory stress composition, and chunk uniqueness.tests/test_taxonomy_and_chunks.py(13 tests): Validation across all 9 personas, 5 memory kinds, teleological discovery, and selective chunk composition.tests/test_wizard_prompts.py(3 tests): Schema requirements, taxonomy guidance, and zero-emoji compliance.
- 100% offline isolation: Zero live network requests or external credentials in test execution.
Empirical Benchmark Summary
| Scenario | Directives | Brief | JIT Chunks | Bloat Cut | Safety Score | Cost / 1k Turns (Dir) | Cost / 1k Turns (JIT) |
|---|---|---|---|---|---|---|---|
| 1: Gmail Slot-Filling | 1,775 tok | 26 tok | 569 tok | 67.9% | 100% | $4.61 | $0.29 |
| 2: Registry Disambiguation | 3,509 tok | 32 tok | 562 tok | 84.0% | 100% | $9.11 | $0.29 |
| 3: DeFi Slippage & Custody | 1,116 tok | 27 tok | 552 tok | 50.5% | 100% | $2.90 | $0.29 |
| 4: Upstream 429 Outage Grace | 1,116 tok | 27 tok | 538 tok | 51.8% | 100% | $2.90 | $0.28 |
| 5: 3-Skill Chain (Mail+Reg+Opt) | 6,005 tok | 86 tok | 1,312 tok | 78.2% | 100% | $15.58 | $0.68 |
Installation
pip install -U mnemolinkContributors
- @rosspeili for the ARPA Skillware Mnemonic Matrix, 3 curated personas, modular AI wizard instructions, and GitHub label sync architecture (#5, #6).
- @bd-c3 for the interactive terminal splash menu, gradient rendering engine, and core CLI dispatch foundations (#1, #2).
Reference Links
- Documentation: docs/
- Skillware Integration Matrix: docs/integrations/skillware_matrix.md
- Personas Library: docs/personas/README.md
- Memories Library: docs/memories/README.md
- Lineages Library: docs/lineages/README.md
- CLI Reference: docs/cli.md
- Usage Guide: docs/usage_guide.md
- Comparison Matrix: COMPARISON.md
- Zenodo Concept DOI: https://doi.org/10.5281/zenodo.22727029
- Full Changelog: CHANGELOG.md