skills.rest
bryan-thompsoncodes
bryan-thompsoncodesCOMMUNITY
Explore all skills by this author →
GitHub

agent-workspace

Organize agent working state into a standardized .notes/.agents directory structure.

Updated Oct 28, 2025
Search Tags:#workflow#notes#archiving#drafts#task-context#agent-workspace
One-click install
npx skills add https://github.com/bryan-thompsoncodes/dotfiles --skill agent-workspace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-workspace
Source: https://github.com/bryan-thompsoncodes/dotfiles/tree/main/dot-config/opencode/skills/agent-workspace
Command: npx skills add https://github.com/bryan-thompsoncodes/dotfiles --skill agent-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Working conventions for agents that separate task context, drafts, and research cache into the .notes/.agents/ directory, providing a clear structure and lifecycle guidance.

Core Features & Use Cases

  • Defines a project-local workspace pattern for muse (task context, progress, threads), sage (research cache), archivist (context visibility), and pyre lifecycle.
  • Specifies directory structure and file conventions for task contexts, progress tracking, drafts, and archiving, ensuring consistent collaboration across agents.
  • Supports integration patterns for task setup, progress updates, research caching, and cleanups, enabling reliable task execution and knowledge retention.

Quick Start

Create and adopt the .notes/.agents/ workspace structure in your project to start recording task context, progress, and research findings.

Frequently Asked Questions about agent-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize ephemeral notes and agent workspaces for task-based workflows?▼

To standardize agent workspaces, you can enforce a structured directory layout under .notes/.agents/ with defined file types like context.md, progress.md, and drafts/ to manage working state and research findings.

What is the best way to organize task context and drafts for AI agents?▼

Organizing task context and drafts is best achieved by adopting a project-local notes framework that separates context, progress, threads, and research cache into specific markdown files within a centralized .notes/.agents/ directory.

How does the .notes/.agents directory structure manage the agent task lifecycle?▼

The .notes/.agents directory manages the agent task lifecycle by providing structured file conventions for task setup, progress tracking, research caching, and cleanups, including lifecycle guidance for task completion and archive management.

Can I use a centralized notes framework to cache research findings across different agents?▼

Yes, you can use a centralized notes framework to cache research findings across agents. The structure supports task-based workflows across multiple components, ensuring consistent collaboration and reliable knowledge retention.

What file types are defined for tracking progress and sources in a project-local workspace?▼

Defined file types for tracking progress and sources in a project-local workspace include context.md, progress.md, threads.md, findings.md, sources.md, and a drafts/ directory for working state.

Related Skills

Explore More Content & Communication Skills→
pingmepipingmepi

pm-os-install

Automate PM-OS installation and configuration with pm_os_install.py.

Community
Basic
lotea-belotea-be
2

openspec-archive-change

Archive completed OpenSpec workflow changes into date-stamped directories.

Official
Advanced
SnowboardTechieSnowboardTechie

agent-workspace

Define standardized .notes/.agents directory conventions for agent task context.

Community
Advanced
LibPDF-jsLibPDF-js
1.8k

create-scratch

Create scratch notes with unique IDs in the .agents/scratches directory.

Official
Intermediate