From 2fce02da1f5863300c32017ebd82920209ab1d64 Mon Sep 17 00:00:00 2001 From: Seth Luersen Date: Fri, 13 Nov 2026 14:22:06 -0800 Subject: [PATCH] Scaffold the Pride: manifesto, Lion steward, skill template, CI Same layout as the other AgenticED Guild repos (from parliament-certification), adapted for The Pride (Content As Code) with the Lion as steward: MANIFESTO.md from the design handoff, README, AGENTS.md/CLAUDE.md, CONTRIBUTING, CODEOWNERS placeholders, agents/lion/, skills/_template/, PR template and the skill validation workflow. Merge wording follows the AgenticED policy: the Lion merges minor changes and tells the leads; humans decide everything else. Co-Authored-By: Claude Opus 5.5 --- .claude/skills/.gitkeep | 0 .github/PULL_REQUEST_TEMPLATE.md | 11 +++++++++ .github/workflows/validate.yml | 30 +++++++++++++++++++++++++ .gitignore | 12 ++++++++++ AGENTS.md | 23 +++++++++++++++++++ CLAUDE.md | 1 + CODEOWNERS | 7 ++++++ CONTRIBUTING.md | 25 +++++++++++++++++++++ MANIFESTO.md | 38 ++++++++++++++++++++++++++++++++ README.md | 29 ++++++++++++++++++++++++ agents/lion/AGENT.md | 27 +++++++++++++++++++++++ agents/lion/README.md | 6 +++++ agents/lion/agent.yaml | 13 +++++++++++ skills/_template/README.md | 19 ++++++++++++++++ skills/_template/SKILL.md | 33 +++++++++++++++++++++++++++ 15 files changed, 274 insertions(+) create mode 100644 .claude/skills/.gitkeep create mode 100644 .github/PULL_REQUEST_TEMPLATE.md create mode 100644 .github/workflows/validate.yml create mode 100644 .gitignore create mode 100644 AGENTS.md create mode 100644 CLAUDE.md create mode 100644 CODEOWNERS create mode 100644 CONTRIBUTING.md create mode 100644 MANIFESTO.md create mode 100644 README.md create mode 100644 agents/lion/AGENT.md create mode 100644 agents/lion/README.md create mode 100644 agents/lion/agent.yaml create mode 100644 skills/_template/README.md create mode 100644 skills/_template/SKILL.md diff --git a/.claude/skills/.gitkeep b/.claude/skills/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..a01fcf2 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,11 @@ +## What this changes + + + +## Checklist + +- [ ] One skill or agent per pull request +- [ ] `SKILL.md` has `name` and `description` +- [ ] The folder works alone +- [ ] If adapted from another project, `source` and the original license are included +- [ ] I tested it on: diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml new file mode 100644 index 0000000..a448f44 --- /dev/null +++ b/.github/workflows/validate.yml @@ -0,0 +1,30 @@ +name: Validate skills + +on: + pull_request: + push: + branches: [main] + +jobs: + validate: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - name: Check each skill has a SKILL.md with name and description + run: | + status=0 + for dir in skills/*/; do + [ -d "$dir" ] || continue + base=$(basename "$dir") + case "$base" in _*) continue ;; esac + file="${dir}SKILL.md" + if [ ! -f "$file" ]; then + echo "::error::$dir has no SKILL.md" + status=1 + continue + fi + head -n 1 "$file" | grep -qx -- '---' || { echo "::error file=$file::frontmatter must start on line 1"; status=1; } + grep -q '^name:' "$file" || { echo "::error file=$file::missing name"; status=1; } + grep -q '^description:' "$file" || { echo "::error file=$file::missing description"; status=1; } + done + exit $status diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..bbcface --- /dev/null +++ b/.gitignore @@ -0,0 +1,12 @@ +.DS_Store +.env +.env.* +node_modules/ +__pycache__/ + +# Test results stay with the organization that ran them. +agents/*/tests/results/ + +# Personal Claude Code settings +.claude/settings.local.json +CLAUDE.local.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..5953be9 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,23 @@ +# Agent instructions for the Pride + +This repo holds skills and agents for Content As Code. It is one of the AgenticED Guild repos. + +## Layout + +- `skills//SKILL.md`: one skill per folder. `skills/_template/` is the starting point. +- `agents//`: one agent per folder. `agents/lion/` is the Guild steward. +- `.claude/skills/`: tooling for contributors to this repo. These are not published skills. + +## Rules + +- Change one skill per pull request. +- Keep every skill folder self-contained. Do not reference files outside it. +- Keep `name` and `description` in every `SKILL.md` frontmatter. CI rejects a skill without them. +- Do not change LICENSE, CODEOWNERS, or files under `.github/` unless a human asks. +- Do not merge pull requests. Only the Lion merges, and only minor changes under the + AgenticED merge policy; a human Guild lead decides every other merge. +- Never commit credentials, tokens, or an organization's private data. + +## Style + +Write in active voice. Prefer short sentences and concrete instructions. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..43c994c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/CODEOWNERS b/CODEOWNERS new file mode 100644 index 0000000..d7b8105 --- /dev/null +++ b/CODEOWNERS @@ -0,0 +1,7 @@ +# Owners of the Pride. Replace the placeholders, then remove the leading "#". +# Human leads approve every pull request except minor changes the Lion merges under the +# AgenticED merge policy. The Guild agent may be added as a reviewer. +# +# * @ +# /skills/ @ +# /agents/ @ diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..addc76b --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,25 @@ +# Contributing to the Pride + +Humans and agents contribute the same way: open a pull request. + +## Add a skill + +1. Copy `skills/_template/` to `skills//`. Use lowercase words joined by hyphens. +2. Fill in `SKILL.md`. The `name` and `description` fields are required. +3. Fill in the skill's `README.md`: what it does, how to install it, what it depends on. +4. Open a pull request. A Guild lead reviews it; the Lion may comment first. + +## Skill checklist + +- [ ] The folder works alone. It references no files outside itself. +- [ ] `SKILL.md` is under 500 lines. Longer detail goes in `references/`. +- [ ] The skill runs on more than one assistant, or the README says which it needs. +- [ ] If adapted from another project, `source` names it and the original license is in the folder. +- [ ] The skill states its limits: what it does not do. + +## Review + +Each pull request needs approval from one human Guild lead. Agents may review +and suggest changes. The Lion may merge a minor change (wording, README, description, +or a patch version bump that passes validation) and tells the leads when it does. +Everything else is merged by a human Guild lead. diff --git a/MANIFESTO.md b/MANIFESTO.md new file mode 100644 index 0000000..97bdb28 --- /dev/null +++ b/MANIFESTO.md @@ -0,0 +1,38 @@ +# The Pride Manifesto + +_From the AgenticED design handoff. Members change this manifesto with a pull request._ + +## Why this Guild exists + +Keep learning content evergreen by treating it as code: versioned source that agents and +applications turn into the learner's interface at the moment of use. + +## Who we are + +Docs-as-code writers, learning engineers, developer educators and generative UI builders. + +## What we value + +- **Structured source** over finished pages. We keep facts, objectives and examples as + plain, versioned source. Everything a learner sees is built from it. +- **Generated at the moment of use** over static learning assets. The learner's interface + is generated when they need it, for their task, from the current source. It is never out + of date. +- **Agents and applications** over documents to read. Content as code is agentified and + applicationified: it runs as agents that coach and applications that respond. +- **Humans at the helm** over unattended generation. The Lion reviews and proposes. A human + Guild lead decides what merges. + +That is, while there is value in the items on the right, we value the items on the left more. + +## What we build + +- Skills that turn structured learning source (facts, objectives, examples) into the + interface a learner needs: explanations, practice, job aids, checks. +- Skills that keep source current: detect drift against product docs and releases, and + propose updates as pull requests. +- Agents that coach learners from the current source, and applications that respond to + the learner's task. +- Shared schemas and conventions for learning content kept in version control. + +AgenticED's shared principles follow the ADGIE framework: https://adgie.ai diff --git a/README.md b/README.md new file mode 100644 index 0000000..4953e62 --- /dev/null +++ b/README.md @@ -0,0 +1,29 @@ +# The Pride + +The AgenticED Guild for Content As Code. This repo holds the Guild's skills and agents. +Humans at the helm, with the Lion as steward. + +- **Guild agent:** the Lion (lion@mail.agentic-ed.org) +- **Manifesto:** [MANIFESTO.md](MANIFESTO.md) +- **Contribute:** [CONTRIBUTING.md](CONTRIBUTING.md) + +## Skills + +Each skill lives in `skills//`. To use one, copy its folder into your +assistant's skills directory. Each skill's README gives install steps and dependencies. + +| Skill | What it does | +|---|---| +| _None yet_ | | + +## Agents + +Each agent lives in `agents//`. + +| Agent | What it does | +|---|---| +| [Lion](agents/lion/) | Guild steward. Reviews pull requests and helps maintain this Guild's skills. | + +## License + +MIT, unless a skill folder carries its own LICENSE file. diff --git a/agents/lion/AGENT.md b/agents/lion/AGENT.md new file mode 100644 index 0000000..6ca491d --- /dev/null +++ b/agents/lion/AGENT.md @@ -0,0 +1,27 @@ +# The Lion + +The Lion is the steward agent of the Pride, the AgenticED Guild for Content As Code. + +## Role + +Help the Guild's human leads keep the skills and agents in this repo correct, current and +easy to use. Humans stay at the helm. + +## What the Lion does + +- Reviews new pull requests against the checklist in CONTRIBUTING.md and comments. +- Flags skills that fail validation, lack a license, or duplicate another skill. +- Proposes improvements as pull requests for a human lead to review. +- Opens pull requests for builders who save on agentic-ed.org without a GitHub account, + crediting them by name. +- Merges **minor** changes only (wording, README, description, or a patch version bump that + passes validation), following the AgenticED merge policy, and tells the Guild leads each + time. Every other change waits for a human Guild lead. + +## Boundaries + +- Never merges a pull request it opened, a new skill or agent, or any change to risk, + scripts, connectors, subagents, licenses, CODEOWNERS or workflows. A human Guild lead + decides those. +- Does not change LICENSE, CODEOWNERS, or files under .github/. +- Works only in this repo. diff --git a/agents/lion/README.md b/agents/lion/README.md new file mode 100644 index 0000000..b010f35 --- /dev/null +++ b/agents/lion/README.md @@ -0,0 +1,6 @@ +# The Lion + +Steward agent for the Pride. See [AGENT.md](AGENT.md) for its role and boundaries +and [agent.yaml](agent.yaml) for its configuration. + +Contact: lion@mail.agentic-ed.org diff --git a/agents/lion/agent.yaml b/agents/lion/agent.yaml new file mode 100644 index 0000000..c47e683 --- /dev/null +++ b/agents/lion/agent.yaml @@ -0,0 +1,13 @@ +name: lion +title: The Lion +role: guild-steward +guild: pride +practice: content-as-code +email: lion@mail.agentic-ed.org +github: # the agent's GitHub handle, once the account exists +risk: medium # writes to this repo through pull requests +systems: + - github: Agentic-ED/pride-content-as-code +skills: [] # skills this agent uses, by path +models: {} # recommended model per provider +version: 0.1.0 diff --git a/skills/_template/README.md b/skills/_template/README.md new file mode 100644 index 0000000..9be8048 --- /dev/null +++ b/skills/_template/README.md @@ -0,0 +1,19 @@ +# Your Skill Name + +What this skill does, in two sentences. + +## Video + + + +## Install + +Copy this folder into your assistant's skills directory. + +## Dependencies + + + +## Example + + diff --git a/skills/_template/SKILL.md b/skills/_template/SKILL.md new file mode 100644 index 0000000..57dd593 --- /dev/null +++ b/skills/_template/SKILL.md @@ -0,0 +1,33 @@ +--- +name: your-skill-name +description: One sentence saying what this skill does and when to use it. +guild: pride +creature: +stage: +risk: low +related: [] +source: +license: MIT +version: 0.1.0 +--- + +# Your Skill Name + +One paragraph: what this skill produces and for whom. + +## Inputs + +What the skill needs before it starts, and what to do when something is missing. + +## Steps + +1. First step. +2. Second step. + +## Output + +What the skill delivers, in what format. + +## Limits + +What this skill does not do.