itzamna-project-operations

Inspect Itzamna configuration and memory files, then propose gated updates.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/KrystianYCSilva/math-theory-lib --skill itzamna-project-operations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: itzamna-project-operations
Source: https://github.com/KrystianYCSilva/math-theory-lib/tree/main/.gemini/skills/itzamna-project-operations
Command: npx skills add https://github.com/KrystianYCSilva/math-theory-lib --skill itzamna-project-operations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents unsafe or unsanctioned agent edits to repository-level Itzamna configuration and short-term memory by providing a read-only verification workflow and a human-gated proposal mechanism for minimal, auditable changes.

Core Features & Use Cases

  • Read-only verification: Check presence and expected structure of .itzamna/, .context/, and related templates before any modification.
  • Safe CLI file handling: Detect CLI-generated files that lack Itzamna references and propose non-destructive appends only after human approval.
  • Drafting and diffing: Produce proposed .context/* and .itzamna/memory.md drafts with clear diffs and rationale for maintainer review.
  • Human gate and audit: Log approvals, never overwrite authoritative files, and produce a concise final status report summarizing findings and proposed actions.

Quick Start

Ask the agent to verify the repository's .itzamna and .context files, produce proposed drafts and diffs for any templated sections, and request human approval before applying any changes.

Frequently Asked Questions about itzamna-project-operations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely automate updates to repository configuration files without overwriting CLI-generated artifacts?

To safely automate repository configuration updates, use a human-gated workflow that performs read-only verification and generates draft diffs for approval. This prevents agents from overwriting CLI-generated artifacts by requiring explicit human consent before any writes.

What is a human-gated workflow for agent memory and context file management?

A human-gated workflow for agent memory and context files is a process where agents draft proposed updates and diffs for maintainer review. It ensures safe handling of short-term memory files by logging approvals and never overwriting authoritative files without explicit consent.

How do I verify the structure of .itzamna and .context directories before applying agent changes?

You verify .itzamna and .context directory structure by running a read-only inspection that checks for expected templates and configuration presence. This verification occurs before any modification, ensuring the repository meets structural requirements prior to proposing updates.

Can I append Itzamna references to existing CLI-generated files without breaking them?

Yes, you can append Itzamna references to CLI-generated files through a non-destructive proposal mechanism. The system detects files lacking references and drafts append-only changes, requiring human approval before applying any modifications to avoid breaking existing artifacts.

What's the best way to draft and review diffs for project memory and context templates?

The best way to draft and review diffs for project memory and context templates is to generate proposed content with clear rationale for maintainer review. This human-gated approach produces auditable changes and a concise final status report summarizing findings.

Why does my agent overwrite repository configuration instead of proposing changes for approval?

Agents overwrite repository configuration when lacking a human gate to enforce read-only verification before writes. Implementing a gated proposal mechanism prevents unsanctioned edits by requiring explicit human consent and logging all approvals prior to applying modifications.