القائمة
Append raw sources to the brain and create or update theme pages. Never modifies raw in place; never deletes.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/parsoFish/forge-studio --skill brain-ingestيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Interactively author a new Studio skill, hook, or template file-package — describe the job, draft the package one turn at a time, iterate on operator feedback, and save it once the operator is satisfied.
Implement a plan and make the project's checks pass.
Turn a unit of work into a short, concrete implementation plan a dev agent can execute.
عرض SKILL.md
| name | brain-ingest |
| description | Append raw sources to the brain and create or update theme pages. Never modifies raw in place; never deletes. |
| library | true |
| phase | brain |
| surface | unattended |
| purpose | Ingest operator-provided raw sources into the brain — append to brain/_raw/, create or update theme pages, update category indexes, and log to brain/forge-dev/log.md. |
| composition | {"skills":["brain-query"],"tools":[],"mcps":[],"guards":["event-log"]} |
| runtime | {"sdk":"claude","strategy":"fixed","model":"claude-haiku-4-5-20251001"} |
| brainAccess | mandatory |
| interactivity | Unattended; operator supplies source identifier + optional category/project target; agent runs to completion without human input. |
| allowed-tools | ["Read","Write","Edit","Bash"] |
| disallowed-tools | ["Task","Agent"] |
| budgets | {"maxBudgetUsd":2} |
Manual / research ingest path. Takes raw input (text, URL contents, external research, or pending human guidance notes) and:
brain/_raw/ with full provenance.brain/cycles/themes/ (forge-wide) or brain/projects/<name>/themes/ (project-specific).brain/forge-dev/log.md._guidance/*.md files (human-originated, the twin of brain-gaps.jsonl) and deletes each one after incorporation.Writer ownership: the reflector is the de-facto writer during cycle execution — it directly writes themes + category indexes as part of closing a cycle. This skill is the manual ingest path for operator-initiated research, external docs, or ad-hoc raw sources that don't arrive via the cycle pipeline. Both paths follow the same theme-page format and append-only raw convention.
Invoke brain-query with:
_raw/ that overlap with what's about to be ingested?"This avoids creating duplicate themes or re-ingesting overlapping raw.
pattern, antipattern, decision, operation, reference).brain/<kb-id>/_guidance/*.md (always checked on each pass — see the Guidance Consume step below).brain/_raw/<...>.md (with mandatory frontmatter — see brain/_raw/README.md).brain/cycles/themes/<slug>.md or brain/projects/<name>/themes/<slug>.md.brain/cycles/<category>.md or ).brain/projects/<name>/<category>.mdbrain/forge-dev/log.md.brain-ingest.start — with source identifier.brain-ingest.raw-appended — file path written.brain-ingest.theme-created or brain-ingest.theme-updated — slug + category.brain-ingest.index-updated — which category index.brain-ingest.guidance-consumed — file path consumed and deleted.brain-ingest.guidance-escalated — guidance note that couldn't be auto-incorporated (floated to a new theme page or logged).brain-ingest.end.Brain query first to check for overlap.
Guidance consume step (always run before the main ingest, once per kb-id in scope):
a. Call listPendingGuidance(forgeRoot, kbId) (exported from orchestrator/kb-graph.ts) to enumerate brain/<kb-id>/_guidance/*.md.
b. For each pending guidance note:
target_node slug: find the corresponding theme file; append the guidance text as a human annotation block (fenced, labelled <!-- guidance -->) and update updated_at.target_node (floating note): decide whether the text fits an existing theme (brain-query to check) or warrants a new one. Treat it like a new raw source without provenance metadata.# ESCALATED so the operator can act on it later.
c. After incorporating each note, call deleteGuidanceFile(forgeRoot, kbId, filePath) to remove it. The guidance node disappears from the KB graph on the next graph build.
d. Emit brain-ingest.guidance-consumed (or brain-ingest.guidance-escalated) for each note.This is the human-originated twin of the
brain-gaps.jsonlloop. Gaps come from brain-query (unanswered agent questions); guidance comes from the operator via the Studio UI pin button. Both feed into the same ingest resolution process.
Fetch / load the source. Clean (de-paginate, ad-strip) but preserve content.
Write to brain/_raw/<source-type>/<slug>.<source-type>.md with mandatory frontmatter.
Decide: does this fit an existing theme, or does it warrant a new one?
brain/cycles/themes/<slug>.md (or project-scoped) following the format in brain/cycles/themes/README.md — including keywords and related_themes. Add to the relevant category index, and link it: set related_themes to the sibling/hub slugs surfaced by the de-dup query in step 1, add the reciprocal entry + a ## See also bullet to each of those themes, so the new page is not an island.Append to brain/forge-dev/log.md: ## [<YYYY-MM-DD>] ingest | <source-type>: <slug>.
_raw/ file after creation. Corrections are new raw sources with theme-page notes about supersession.deleteGuidanceFile only after the note has been incorporated (or escalated). Do not delete without incorporating — guidance is the operator's intent and must not be silently discarded.