workspace-rules

Enforces output routing, formatting, and frontmatter rules for .giantmem/ workspace artifacts.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/bearded-giant/claude-code-config --skill workspace-rules-bearded-giant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-rules
Source: https://github.com/bearded-giant/claude-code-config/tree/main/skills/workspace-rules
Command: npx skills add https://github.com/bearded-giant/claude-code-config --skill workspace-rules-bearded-giant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-generated documentation often lands in the wrong directories, lacks consistent metadata, or uses verbose formatting that pollutes a workspace. This Skill enforces deterministic rules for where files go, how they are named, and what frontmatter they carry inside a .giantmem/ workspace. ## Core Features & Use Cases - Directory Routing: Routes plans, research, reviews, and filebox content to feature-scoped or global .giantmem/ subdirectories based on active feature state. - Frontmatter Enforcement: Requires YAML frontmatter with type, status, lifecycle, and scope keys on every Markdown and YAML artifact, plus lifecycle tiers (durable, candidate, deprecated) for retention management. - Style and Anti-Pattern Rules: Mandates caveman-style compression on first write, bans progress-tracking headers, and defines concise output formats with tables over prose. - Use Case: When you ask the AI to "save findings" or "write a plan", the Skill automatically places the file in the correct feature directory with proper frontmatter, snake_case naming, and an Open Questions block at the top. ## Quick Start Ask the AI to save your research findings or write an implementation plan, and it will route the file to the correct .giantmem/ subdirectory with compliant frontmatter and formatting.

Frequently Asked Questions about workspace-rules

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

FAQPage Schema
How do I organize AI-generated docs in a .giantmem workspace?

Route files by type: plans go to plans/, research to research/, reviews to reviews/, and reference docs to context/. When a feature is in progress, these directories live inside the active feature folder instead of the workspace root.

What frontmatter is required for workspace Markdown files?

Every .md and .yaml artifact needs YAML frontmatter with type, status, created, and updated fields, plus either a feature or repo key. Optional keys include lifecycle, scope, domain, and publish for Notion mirroring.

Should AI output go to the repo docs/ folder?

No. Repo docs/ is human-owned shipped documentation and must never be written to unprompted. AI-generated output routes to .giantmem/context/ or the active feature's research/ directory instead.

What is the difference between tasks.md and plans/current.md?

tasks.md is a durable OpenSpec-style checkbox list archived with the feature, with auto-status from checkbox percentage. plans/current.md is a transient session scratchpad that mutates during work and is deleted on feature completion.

How does artifact lifecycle management work?

Artifacts carry a lifecycle of durable, candidate, or deprecated. Candidates are AI-captured findings triaged via /review-memory, while retention tiers derived from type determine staleness windows surfaced by giantmem artifact stale.