Rename .pi to .feynman, rename citation agent to verifier, add website, skills, and docs
- Rename project config dir from .pi/ to .feynman/ (Pi supports this via piConfig.configDir) - Rename citation agent to verifier across all prompts, agents, skills, and docs - Add website with homepage and 24 doc pages (Astro + Tailwind) - Add skills for all workflows (deep-research, lit, review, audit, replicate, compare, draft, autoresearch, watch, jobs, session-log, agentcomputer) - Add Pi-native prompt frontmatter (args, section, topLevelCli) and read at runtime - Remove sync-docs generation layer — docs are standalone - Remove metadata/prompts.mjs and metadata/packages.mjs — not needed at runtime - Rewrite README and homepage copy - Add environment selection to /replicate before executing - Add prompts/delegate.md and AGENTS.md Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
53
AGENTS.md
Normal file
53
AGENTS.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# Agents
|
||||
|
||||
`AGENTS.md` is the repo-level contract for agents working in this repository.
|
||||
|
||||
Pi subagent behavior does **not** live here. The source of truth for bundled Pi subagents is `.feynman/agents/*.md`, which the runtime syncs into the Pi agent directory. If you need to change how `researcher`, `reviewer`, `writer`, or `verifier` behave, edit the corresponding file in `.feynman/agents/` instead of duplicating those prompts here.
|
||||
|
||||
## Pi subagents
|
||||
|
||||
Feynman ships four bundled research subagents:
|
||||
|
||||
- `researcher`
|
||||
- `reviewer`
|
||||
- `writer`
|
||||
- `verifier`
|
||||
|
||||
They are defined in `.feynman/agents/` and invoked via the Pi `subagent` tool.
|
||||
|
||||
## What belongs here
|
||||
|
||||
Keep this file focused on cross-agent repo conventions:
|
||||
|
||||
- output locations and file naming expectations
|
||||
- provenance and verification requirements
|
||||
- handoff rules between the lead agent and subagents
|
||||
- remote delegation conventions
|
||||
|
||||
Do **not** restate per-agent prompt text here unless there is a repo-wide constraint that applies to all agents.
|
||||
|
||||
## Output conventions
|
||||
|
||||
- Research outputs go in `outputs/`.
|
||||
- Paper-style drafts go in `papers/`.
|
||||
- Session logs go in `notes/`.
|
||||
- Plan artifacts for long-running workflows go in `outputs/.plans/`.
|
||||
- Intermediate research artifacts such as `research-web.md` and `research-papers.md` are written to disk by subagents and read by the lead agent. They are not returned inline unless the user explicitly asks for them.
|
||||
|
||||
## Provenance and verification
|
||||
|
||||
- Every output from `/deepresearch` and `/lit` must include a `.provenance.md` sidecar.
|
||||
- Provenance sidecars should record source accounting and verification status.
|
||||
- Source verification and citation cleanup belong in the `verifier` stage, not in ad hoc edits after delivery.
|
||||
- Verification passes should happen before delivery when the workflow calls for them.
|
||||
|
||||
## Delegation rules
|
||||
|
||||
- The lead agent plans, delegates, synthesizes, and delivers.
|
||||
- Use subagents when the work is meaningfully decomposable; do not spawn them for trivial work.
|
||||
- Prefer file-based handoffs over dumping large intermediate results back into parent context.
|
||||
- When delegating to remote machines, retrieve final artifacts back into the local workspace and save them locally.
|
||||
|
||||
## Remote delegation
|
||||
|
||||
Feynman can delegate tasks to remote cloud machines via the `computer-fleet` and `computer-acp` skills. Load those skills on demand for CLI usage, session management, ACP bridging, and file retrieval.
|
||||
Reference in New Issue
Block a user