fix(kyberforge): trim forge description and body to ADR-0020 budgets #145
No files matched your search
@@ -11,7 +11,7 @@
|
|||||||
{
|
{
|
||||||
"name": "kyberforge",
|
"name": "kyberforge",
|
||||||
"description": "Skills and agents for creating, maintaining, and managing an apm plugin marketplace for Claude Code and GitHub Copilot.",
|
"description": "Skills and agents for creating, maintaining, and managing an apm plugin marketplace for Claude Code and GitHub Copilot.",
|
||||||
"version": "2.0.1",
|
"version": "2.0.2",
|
||||||
"category": "Developer Tools",
|
"category": "Developer Tools",
|
||||||
"source": "./plugins/kyberforge"
|
"source": "./plugins/kyberforge"
|
||||||
},
|
},
|
||||||
|
|||||||
@@ -61,7 +61,7 @@ dependencies:
|
|||||||
# an apm mechanic.
|
# an apm mechanic.
|
||||||
executables:
|
executables:
|
||||||
allow:
|
allow:
|
||||||
kyberforge#2.0.1:
|
kyberforge#2.0.2:
|
||||||
hooks: true
|
hooks: true
|
||||||
bin: true
|
bin: true
|
||||||
|
|
||||||
|
|||||||
@@ -1,31 +1,27 @@
|
|||||||
---
|
---
|
||||||
name: forge
|
name: forge
|
||||||
description: >
|
description: >
|
||||||
Use when the user wants to build or improve something but has not yet named
|
Use when the user wants to build or improve something without naming the
|
||||||
the artifact type — skill, agent, plugin, or marketplace entry; "not sure if
|
artifact type ("not sure if this should be a skill or a plugin"). Not a named
|
||||||
this should be a skill or a plugin", "I have an idea but don't know where it
|
skill -> `skill-author`. Not a named agent -> `agent-author`. Not a named
|
||||||
belongs". Routes to the matching author skill. Do not use when the type is
|
plugin -> `apm-workflow`.
|
||||||
already named — invoke `skill-author`, `agent-author` or `apm-workflow`
|
|
||||||
directly.
|
|
||||||
metadata:
|
metadata:
|
||||||
version: "1.0.1"
|
version: "1.0.2"
|
||||||
category: factory
|
category: factory
|
||||||
source_keys:
|
source_keys:
|
||||||
- claude-code-subagents-docs
|
- claude-code-subagents-docs
|
||||||
- context7-websites-code-claude
|
|
||||||
- agentskills-spec
|
- agentskills-spec
|
||||||
---
|
---
|
||||||
|
|
||||||
## Gotchas
|
## Gotchas
|
||||||
|
|
||||||
- forge is an optional guided entry point, not a gate — `skill-author`, `agent-author`, `factory-audit` and `apm-workflow` all stay directly invokable, and forge never intercepts a direct call to one.
|
- forge is an optional guided entry point, not a gate — `skill-author`, `agent-author`, `factory-audit` and `apm-workflow` all stay directly invokable, and forge never intercepts a direct call to one.
|
||||||
- Claude Code's skill-level `context: fork` frontmatter field and the `/fork` subagent command are opposites despite the shared word: `context: fork` isolates (fresh context, no parent access), while `/fork` inherits the full conversation. The route reference each classification loads spends that distinction: `references/author-routes.md` chooses between the two, `references/apm-routes.md` rules the fork out.
|
|
||||||
|
|
||||||
## Step 1 — Grill the intent
|
## Step 1 — Grill the intent
|
||||||
|
|
||||||
Call `grill-with-docs` unless a grill session has already run and is available in the context.
|
Call `grill-with-docs` unless a grill session has already run and is available in the context.
|
||||||
|
|
||||||
`grill-with-docs` ships in a sibling plugin that kyberforge does not declare as an apm dependency, so it resolves in the authoring monorepo but can be absent where kyberforge is installed alone. If it does not resolve, grill inline yourself rather than skipping the step: what problem the artifact solves, who invokes it and how, what it must refuse, and which existing skill or plugin already owns part of the job. Say which path you took.
|
`grill-with-docs` ships in a sibling plugin kyberforge does not declare as an apm dependency, so it can be absent where kyberforge is installed alone. If it does not resolve, grill inline yourself rather than skipping the step: what problem the artifact solves, who invokes it and how, what it must refuse, and which existing skill or plugin already owns part of the job. Say which path you took.
|
||||||
|
|
||||||
Grilling regularly overturns the artifact type assumed at the start, or splits one idea into several artifacts, so it runs before classification rather than confirming it. Run it inline in the current conversation — grilling is interactive and a subagent cannot hold the back-and-forth.
|
Grilling regularly overturns the artifact type assumed at the start, or splits one idea into several artifacts, so it runs before classification rather than confirming it. Run it inline in the current conversation — grilling is interactive and a subagent cannot hold the back-and-forth.
|
||||||
|
|
||||||
@@ -42,7 +38,7 @@ Match the grilled intent against exactly one row — or more than one, if the in
|
|||||||
|
|
||||||
The table classifies what to build, not how to run it: a one-off task that merely needs an isolated or context-inheriting run is not an artifact and has no row here. If the intent stays genuinely ambiguous between rows after grilling, ask the user rather than guessing.
|
The table classifies what to build, not how to run it: a one-off task that merely needs an isolated or context-inheriting run is not an artifact and has no row here. If the intent stays genuinely ambiguous between rows after grilling, ask the user rather than guessing.
|
||||||
|
|
||||||
A real artifact that matches no row — a hook, an MCP server, an AGENTS.md, a research doc — has no route here. Say so, hand the user the skill that does own it, and never bend it into a row to make the table fit.
|
An artifact that matches no row — a hook, an MCP server, an AGENTS.md, a research doc — has no route here. Say so, hand the user the skill that owns it, and never bend it into a row.
|
||||||
|
|
||||||
When the intent spans several rows, chain the routes in dependency order — an artifact that must exist on disk before another skill can target it goes first, so `apm-workflow` scaffolds the plugin directory before `skill-author` scaffolds a skill inside it.
|
When the intent spans several rows, chain the routes in dependency order — an artifact that must exist on disk before another skill can target it goes first, so `apm-workflow` scaffolds the plugin directory before `skill-author` scaffolds a skill inside it.
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
---
|
---
|
||||||
source_keys:
|
source_keys:
|
||||||
- claude-code-subagents-docs
|
- claude-code-subagents-docs
|
||||||
|
- context7-websites-code-claude
|
||||||
---
|
---
|
||||||
|
|
||||||
# Routing a skill or agent to its author skill
|
# Routing a skill or agent to its author skill
|
||||||
@@ -10,6 +11,13 @@ definition. Route a skill to `skill-author` and an agent to `agent-author`. The
|
|||||||
differ on the author skill only — both verify the result with `factory-audit`, which detects the
|
differ on the author skill only — both verify the result with `factory-audit`, which detects the
|
||||||
artifact type itself — and everything below applies to both.
|
artifact type itself — and everything below applies to both.
|
||||||
|
|
||||||
|
## Gotcha: `context: fork` is not `/fork`
|
||||||
|
|
||||||
|
Claude Code's skill-level `context: fork` frontmatter field and the `/fork` subagent command are
|
||||||
|
opposites despite the shared word: `context: fork` isolates (fresh context, no parent access),
|
||||||
|
while `/fork` inherits the full conversation. The fork-versus-inline choice below is about `/fork`.
|
||||||
|
`references/apm-routes.md` rules the fork out entirely.
|
||||||
|
|
||||||
## Choose fork or inline
|
## Choose fork or inline
|
||||||
|
|
||||||
Default to a **fork subagent**. It inherits the full grilled-intent conversation, so the author
|
Default to a **fork subagent**. It inherits the full grilled-intent conversation, so the author
|
||||||
|
|||||||
@@ -12,8 +12,8 @@
|
|||||||
|
|
||||||
- **URL:** context7:/websites/code_claude
|
- **URL:** context7:/websites/code_claude
|
||||||
- **Research doc:** plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
|
- **Research doc:** plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
|
||||||
- **Description:** Official Claude Code documentation site indexed by Context7 — confirms the `context: fork` skill-level frontmatter field means isolated/fresh execution, the opposite of what the `/fork` subagent command does (inherits conversation). Informs the Gotchas entry in `SKILL.md` warning against conflating the two; nothing else in this skill draws on it, and no `references/` file mentions the `context: fork` field.
|
- **Description:** Official Claude Code documentation site indexed by Context7 — confirms the `context: fork` skill-level frontmatter field means isolated/fresh execution, the opposite of what the `/fork` subagent command does (inherits conversation). Informs the `context: fork` gotcha in `references/author-routes.md` warning against conflating the two; nothing else in this skill draws on it.
|
||||||
- **Contributing files:** SKILL.md
|
- **Contributing files:** references/author-routes.md
|
||||||
- **Status:** `extracted`
|
- **Status:** `extracted`
|
||||||
|
|
||||||
## claude-code-plugins-docs
|
## claude-code-plugins-docs
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
name: kyberforge
|
name: kyberforge
|
||||||
version: 2.0.1
|
version: 2.0.2
|
||||||
description: Skills and agents for creating, maintaining, and managing an apm plugin marketplace for Claude Code and GitHub Copilot.
|
description: Skills and agents for creating, maintaining, and managing an apm plugin marketplace for Claude Code and GitHub Copilot.
|
||||||
author:
|
author:
|
||||||
name: Defame1297
|
name: Defame1297
|
||||||
|
|||||||
Reference in new issue
Block a user