Help us improve
Share bugs, ideas, or general feedback.
From fs-dev
Agent artifact placement conventions. Use when creating plans, tasks, research, reviews, brainstorms, or any agent-generated files. Ensures artifacts go to docs/.claude/ (gitignored) instead of polluting the repo.
npx claudepluginhub fyrsmithlabs/marketplace --plugin fs-devHow this skill is triggered — by the user, by Claude, or both
Slash command
/fs-dev:agent-artifactsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Agent-generated files (plans, tasks, research, reviews, orchestration output) MUST go to `docs/.claude/`, never the repo root. This directory is gitignored per git-repo-standards.
Generates AGENTS.md files in repo folders (root, src/tests/api, monorepos) with build commands, testing, code style, structure, boundaries for coding agents. Only if missing.
Analyzes a project and generates a root AGENTS.md with operational commands, golden rules, and nested AGENTS.md files for high-context zones. Invoke via "AGENTS.md 만들어줘", "에이전트 규칙 만들어줘", or "/agents-md".
Generates hierarchical AGENTS.md structures for codebases to optimize AI agent token usage. Use for repo analysis, monorepos, JIT indexing, and token-efficient root/sub-folder docs.
Share bugs, ideas, or general feedback.
Agent-generated files (plans, tasks, research, reviews, orchestration output) MUST go to docs/.claude/, never the repo root. This directory is gitignored per git-repo-standards.
docs/.claude/
├── tasks/ # Todo lists, checklists, work tracking
├── plans/ # Implementation plans, design docs, architecture
├── research/ # Research results, analysis, findings
├── reviews/ # Consensus review reports, audit results
├── orchestration/ # Orchestration state, dispatch logs
└── brainstorms/ # Brainstorm sessions, ideation output
docs/.claude/<subdir>/ for generated files.claude/fs-dev-settings.json for project-specific overrides| Artifact Type | Directory | Examples |
|---|---|---|
| Plans | docs/.claude/plans/ | implementation plans, design approaches, architecture docs |
| Tasks | docs/.claude/tasks/ | todo lists, checklists, work items |
| Research | docs/.claude/research/ | technical research, competitive analysis, findings |
| Reviews | docs/.claude/reviews/ | consensus review reports, code audits |
| Orchestration | docs/.claude/orchestration/ | multi-agent dispatch state, execution logs |
| Brainstorms | docs/.claude/brainstorms/ | brainstorm transcripts, ideation notes |
Projects can customize via .claude/fs-dev-settings.json:
{
"agentArtifacts": {
"baseDir": "docs/.claude",
"allowedSubdirs": [
"tasks", "plans", "orchestration",
"research", "reviews", "brainstorms"
]
}
}
If the settings file doesn't exist, use the defaults above.
These belong at the repo root — do not redirect them:
CLAUDE.md, .claude.local.md — Claude Code configurationREADME.md, CHANGELOG.md, LICENSE — repo documentation.gitignore, .gitleaks.toml — repo configurationSECURITY.md, CONTRIBUTING.md, CODEOWNERS — repo standards