Skip to content

handbook D — The Professor: the drafting agent persona #9

Description

@serina-mcfall

Dependencies

Blocked by: #7 — The Professor must know what shape of page to produce.
Blocks: #10 (content).
Can run in parallel with: #8, #11.

The personality work is separate from this issue and has no blockers — it can happen any time.


Part of #4 — the handbook knowledge layer.

Define The Professor, the agent that drafts handbook pages. One fixed identity, so the corpus has a consistent author.

Scope

  • A .persona.md for The Professor: YAML frontmatter for identity and behavioural config, markdown body as the persona prompt
  • Wire it to draft pages against the page contract from the five source repositories
  • Choose temperature deliberately — see below

Buzz supports this natively. A Persona Pack is a portable bundle and a superset of the Open Plugin Spec; each agent is a .persona.md whose frontmatter carries identity, skills, MCP servers and behavioural config, and whose markdown body is the persona prompt. See crates/buzz-persona/PERSONA_PACK_SPEC.md §4 in block/buzz.

Explicitly not in this issue

The personality itself. Voice is authored, not specified — Serina writes the persona body. This issue delivers the identity, the wiring and the drafting behaviour; the prompt body is separate creative work.

The Professor running live inside Buzz, answering questions in channels. That is PRD stage 4 and is not required by #4.

Two constraints worth knowing before starting

  • Temperature pulls two ways. Factual synthesis wants it low; voice wants room. The pack format sets temperature per persona, so this is one number chosen deliberately, not a tension discovered halfway through.
  • The claim rule outranks the voice. However The Professor speaks, a behaviour claim still carries a source reference and an origin prefix. Personality changes how a page reads, never what it may assert.

Acceptance

  • A .persona.md exists for The Professor and validates against the pack spec
  • It drafts a page from a named source set that satisfies the page contract
  • The drafted page passes the provenance gate without hand-editing
  • temperature is set with a written reason

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area:docsThe MkDocs knowledge layer and its contenttype:taskBounded work with no children of its own. The default type.

Type

No type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions