@firatcand/roster 0.1.0 → 1.0.0

package/templates/scaffold/projects/_demo/CLAUDE.md

@@ -1,35 +0,0 @@
----
-project: _demo
-type: example
-created: 2026-05-03
----
-
-# Acme Corp — Demo Project
-
-This is a sample project demonstrating how `roster` organizes work. Acme Corp is a fictional B2B SaaS company that helps small businesses automate their accounting workflows.
-
-This demo is **safe to delete**. It exists to show the structure of a populated project. Real projects go in `projects/<your-project-name>/`.
-
-## Identity
-
-- Product: Acme Books — accounting automation for SMBs
-- Stage: early-stage SaaS, post-launch
-- Audience: SMB owners and bookkeepers
-- Primary motion: outbound to bookkeeping firms and SMB owners
-
-## Active agent instances
-
-- `gtm/sdr/projects/_demo/` — outbound prospecting and cold outreach
-
-## Files in this project
-
-- `CLAUDE.md` — this file
-- `state.md` — session continuity (auto-updated)
-- `guidelines/` — substrate (voice, ICPs, messaging, brand-book, etc.)
-
-## How to use as a learning example
-
-1. Browse `projects/_demo/guidelines/` to see what filled-in substrate looks like
-2. Browse `gtm/sdr/projects/_demo/config/default.yaml` to see how an agent instance is configured
-3. Try running the agent against this demo: `/sdr run cold-outreach for _demo` (will prompt for filled bindings — feel free to use placeholder values for the test)
-4. Delete this entire `_demo/` directory and its instance(s) when you're ready to start fresh

package/templates/scaffold/projects/_demo/README.md

@@ -1,16 +0,0 @@
-# _demo
-
-Placeholder project for testing roster workflows. Rename or duplicate this directory to
-create a real project — `scripts/new-project.sh <name>` automates that in Phase 2.
-
-## Structure
-
-```
-projects/_demo/
-├── guidelines/           # written by function-level experts (added in Phase 2)
-├── config/default.yaml   # per-project agent config (added in Phase 2)
-└── state.md              # session continuity notes (max 5 lines; updated via /save-state)
-```
-
-In Phase 1 this directory only proves `roster init` writes files to the right place. The
-full project substrate lands when Phase 2 ships `templates/scaffold/` (see ROS-17).

package/templates/scaffold/projects/_demo/config/default.yaml

@@ -1,28 +0,0 @@
----
-project: _demo
-created: 2026-05-03
----
-
-# Project-level config — Acme Corp demo
-#
-# Cross-agent defaults for this project. Agent-scoped config (per-instance
-# tool bindings, channel caps, scoring thresholds) lives at:
-#   <function>/<agent>/projects/<project>/config/default.yaml
-#
-# Keep this file thin. It's read by chief-of-staff for audit reports and
-# by any agent that needs project-wide signals.
-
-# Display name shown in reports and Slack messages.
-display_name: Acme Corp
-
-# Stage: idea | pre-launch | early | growth | mature
-stage: early
-
-# Primary go-to-market motion. Drives default agent suggestions.
-# Options: outbound | inbound | plg | hybrid
-motion: outbound
-
-# Default approval channel for HITL — used when an agent's instance config
-# leaves approval_channel unset.
-# Options: slack | inline | auto
-approval_channel: auto

package/templates/scaffold/projects/_demo/state.md

@@ -1,11 +0,0 @@
----
-last_session: 2026-05-03
-focus: (none — demo project)
----
-
-# Acme Corp — Session State
-
-This file tracks short-term context across Claude Code sessions for this project. Updated via `/save-state` or by the user explicitly. Five lines max.
-
-- Status: demo / illustrative
-- Next task: replace with your real project, or delete `_demo/` entirely

package/templates/scaffold/scripts/new-project.sh

@@ -1,125 +0,0 @@
-#!/usr/bin/env bash
-# new-project.sh — scaffold a new project substrate inside a roster workspace.
-#
-# Usage:
-#   bash scripts/new-project.sh <project-name> [<function>]
-#
-# Arguments:
-#   project-name   Free-form name. Normalized to kebab-case (lowercase,
-#                  [a-z0-9-], non-alphanumeric runs collapsed to '-').
-#                  Examples:
-#                    "My Co"        -> my-co
-#                    "foo bar/baz"  -> foo-bar-baz
-#                    "Acme Corp 2"  -> acme-corp-2
-#   function       Optional. If provided, must be registered in
-#                  .config/functions.yaml (gtm, product, design, ops, ...).
-#
-# Creates:
-#   projects/<slug>/
-#     guidelines/.gitkeep
-#     config/default.yaml      (project-level config skeleton)
-#     state.md                 (frontmatter + 5-line stub)
-#
-# Exit codes:
-#   0  success
-#   1  usage / validation error
-
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-# shellcheck disable=SC1091
-source "$ROOT/scripts/lib/functions.sh"
-
-usage() {
-  echo "Usage: $0 <project-name> [<function>]" >&2
-  echo "  project-name   Free-form; normalized to kebab-case" >&2
-  echo "  function       Optional; must be in .config/functions.yaml" >&2
-}
-
-if [ $# -lt 1 ] || [ $# -gt 2 ]; then
-  usage
-  exit 1
-fi
-
-RAW_NAME="$1"
-FUNCTION="${2:-}"
-
-normalize() {
-  # 1. lowercase
-  # 2. replace any run of non-alphanumeric chars with a single '-'
-  # 3. trim leading/trailing '-'
-  printf '%s' "$1" \
-    | tr '[:upper:]' '[:lower:]' \
-    | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//'
-}
-
-SLUG="$(normalize "$RAW_NAME")"
-
-if [ -z "$SLUG" ]; then
-  echo "ERROR: project name '$RAW_NAME' is empty after normalization" >&2
-  exit 1
-fi
-
-if ! [[ "$SLUG" =~ ^[a-z][a-z0-9-]*$ ]]; then
-  echo "ERROR: normalized slug '$SLUG' must start with a letter and contain only a-z, 0-9, '-'" >&2
-  exit 1
-fi
-
-if [ -n "$FUNCTION" ]; then
-  if ! is_valid_function "$FUNCTION"; then
-    echo "ERROR: function '$FUNCTION' is not registered in .config/functions.yaml" >&2
-    echo "Registered functions:" >&2
-    read_functions 2>/dev/null | sed 's/^/  - /' >&2 || echo "  (registry empty or missing)" >&2
-    exit 1
-  fi
-fi
-
-TARGET="$ROOT/projects/$SLUG"
-
-if [ -e "$TARGET" ]; then
-  echo "ERROR: project '$SLUG' already exists at $TARGET" >&2
-  exit 1
-fi
-
-TIMESTAMP="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-
-mkdir -p "$TARGET/guidelines" "$TARGET/config" "$TARGET/assets"
-touch "$TARGET/guidelines/.gitkeep" "$TARGET/assets/.gitkeep"
-
-cat >"$TARGET/config/default.yaml" <<EOF
----
-project: $SLUG
-created: ${TIMESTAMP%T*}
----
-
-# Project-level config for $SLUG.
-# Cross-agent defaults. Agent-scoped instance config lives at:
-#   <function>/<agent>/projects/$SLUG/config/default.yaml
-
-display_name: $SLUG
-stage: early
-motion: outbound
-approval_channel: auto
-EOF
-
-cat >"$TARGET/state.md" <<EOF
----
-updated: $TIMESTAMP
----
-
-Last task: (none yet)
-Active artifacts: (none)
-Open questions: (none)
-Next session: fill in guidelines/voice.md and at least one ICP
-Notes: created via scripts/new-project.sh
-EOF
-
-echo "✓ Project '$SLUG' created at projects/$SLUG/"
-echo ""
-echo "Next steps:"
-echo "  1. Fill projects/$SLUG/guidelines/voice.md (3 adjectives + tone)"
-echo "  2. Add at least one ICP under projects/$SLUG/guidelines/icps/"
-echo "  3. Edit projects/$SLUG/config/default.yaml — set display_name, stage, motion"
-if [ -n "$FUNCTION" ]; then
-  echo "  4. Wire an agent instance via chief-of-staff: add-agent-to-project project=$SLUG function=$FUNCTION agent=<name>"
-fi