agent-registry

Dynamic agent registry via js-doc-store-server. Store, version, and discover subagent definitions in a database instead of static markdown files.

الانتقال إلى التثبيت

المستودع: MauricioPerera/pi-extension-data-architect
آخر نشاط في المصدر: ١٢ مايو ٢٠٢٦ في ٢٢:٥٣
لغة SKILL.md المكتشفة: الإنجليزية
النجوم: ٠
التفرعات: ٠

خيارات التثبيت

يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.

npx skills add https://github.com/MauricioPerera/pi-extension-data-architect --skill agent-registry

يبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.

تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.

مراجعة ملفات المصدر

اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.

SKILL.md

تعليمات المصدر · معاينة للقراءة فقط

العودة إلى البحث العودة إلى التثبيت

flow-engine

Pi extension for workflow automation enabling resilient server startup procedures and agent-based workflow orchestration.

2026-05-13

skill-registry

Meta-skill pattern for dynamic skill discovery. Keep only ONE SKILL.md on filesystem; query all specialized skills on-demand from js-doc-store-server by tags.

2026-05-13

task-manager

Persistent task management with subagent orchestration. Create tasks, assign to agents, track execution, and build workflows via js-doc-store-server.

2026-05-12

عرض الكل من هذا المستودع

Filesystem (~/.pi/agent/agents/)
├── scout.md
├── planner.md
├── reviewer.md
└── worker.md

js-doc-store-server (localhost:3000)
└── table: agents
    ├── scout     → content: full markdown
    ├── planner   → content: full markdown
    ├── reviewer  → content: full markdown
    ├── worker    → content: full markdown
    └── custom    → user-defined agents

{
  "tableName": "agents",
  "columns": [
    { "name": "name",        "type": "text", "required": true },
    { "name": "description", "type": "text" },
    { "name": "version",     "type": "text" },
    { "name": "tags",        "type": "text" },
    { "name": "model",       "type": "text" },
    { "name": "tools",       "type": "text" },
    { "name": "content",     "type": "text", "required": true },
    { "name": "source",      "type": "text" }
  ]
}

---
name: scout
description: Fast codebase reconnaissance
tools: read, grep, find, ls, bash
model: qwen3.6:latest
---

You are a scout. Quickly investigate a codebase and return structured findings...

// 1. Discover by topic (optional)
const results = await arch_query({
  tableName: "agents",
  filter: { tags: { $regex: "review" } }
});

// 2. Register new agent from conversation
await arch_insert({
  tableName: "agents",
  data: {
    name: "security-auditor",
    description: "Audits code for security vulnerabilities",
    version: "1.0.0",
    tags: "security,audit,subagent",
    model: "qwen3.6:latest",
    tools: "read, grep, find, ls, bash",
    content: `---\nname: security-auditor\n...\n---\n\nYou are a security auditor...`,
    source: "registry"
  }
});

// 3. Verify
const all = await arch_query({ tableName: "agents", filter: {} });

Task	Tool Sequence
Discover by topic	`arch_query` → filter `tags: { $regex: "topic" }`
Load full agent	`arch_query` → filter `name: "exact-name"` → read `.content`
Register new agent	`arch_insert` into `agents` table
Update agent version	`arch_update` with `$set: { version, content }`
List all agents	`arch_query` with empty filter
Delete obsolete agent	`arch_remove` with filter `{ name: "agent-name" }`

Benefit	Explanation
Cross-machine portability	Agents follow your `js-doc-store-server`
Versioning	Field `version` tracks agent evolution
Tag Search	Find agents by topic, not just filename
Cross-session persistence	Agents survive pi restarts
Easy Registration	New agent = 1 `arch_insert` call
Centralized Source	Single `agents` table
Hybrid Fallback	Works with or without server

Issue	Consequence
Agents scattered across machines	No portability between workspaces
No versioning	Agent definitions evolve but files don't track it
No dynamic updates	Must restart pi to see new agents
No sharing	Can't reuse agent definitions across projects

Issue	Consequence
Agents scattered across machines	No portability between workspaces
No versioning	Agent definitions evolve but files don't track it
No dynamic updates	Must restart pi to see new agents
No sharing	Can't reuse agent definitions across projects

agent-registry

خيارات التثبيت

مراجعة ملفات المصدر

Agent Registry — Dynamic Agent Discovery

Problem with Static Filesystem Agents

Agent Registry — Dynamic Agent Discovery

Problem with Static Filesystem Agents

The Registry Pattern

Schema

Agent Markdown Format

How Discovery Works

Workflow: Register a New Agent

Tool Combinations for Agent Management

Server-Side Fallback

Benefits

Migration from Filesystem to Registry

See Also

name	agent-registry
version	1.0.0
tags	agents,subagent,registry,discovery,dynamic,persistence,architecture
author	MauricioPerera
description	Dynamic agent registry via js-doc-store-server. Store, version, and discover subagent definitions in a database instead of static markdown files.

agent-registry

معلومات المصدر

خيارات التثبيت

مراجعة ملفات المصدر

المزيد من هذا المستودع

المزيد من هذا المستودع

Agent Registry — Dynamic Agent Discovery

Problem with Static Filesystem Agents

Agent Registry — Dynamic Agent Discovery

Problem with Static Filesystem Agents

The Registry Pattern

Schema

Agent Markdown Format

How Discovery Works

Workflow: Register a New Agent

Tool Combinations for Agent Management

Server-Side Fallback

Benefits

Migration from Filesystem to Registry

See Also