Update project assets and consolidate agent instructions (#30)

* Update project assets and consolidate agent instructions

- Refactor CLAUDE.md to point to AGENTS.md as single source of truth
- Update AGENTS.md: Go 1.23+ → 1.25+, add missing repo layout entries,
  consolidate build/test/lint section with all Makefile targets,
  replace br (beads-rust) issue tracking with GitHub CLI (gh),
  update release status to shipped
- Update README.md: Go 1.23+ → 1.25+
- Fix docs copyright year: 2025 → 2026

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Remove beads-rust assets and references

- Delete .beads/ directory (config, issues, metadata, db)
- Remove .bv/ entry from .gitignore
- Update docs/contributing/index.md: replace br commands with gh CLI,
  fix Go version 1.23+ → 1.25+

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Remove beads.db binary that was accidentally tracked

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: devrimcavusoglu

.beads/.gitignore

@@ -22,9 +22,6 @@ Thumbs.db
 # Manual test reports (per-run artifacts)
 tests/manual/reports/
 
-# bv (beads viewer) local config and caches
-.bv/
-
 # Docs (VitePress)
 docs/.vitepress/cache
 docs/.vitepress/dist

.beads/config.yaml

@@ -4,7 +4,7 @@
 
 Skern is a minimal, agent-first CLI tool for managing Agent Skills across agentic development platforms (Claude Code, Codex CLI, OpenCode). It follows the Agent Skills open standard (agentskills.io) and uses `SKILL.md` files with YAML frontmatter as the canonical format.
 
-The project is written in **Go 1.23+** and is preparing for its first release (**v0.0.1**).
+The project is written in **Go 1.25+** and has shipped its first release (**v0.0.1**).
 
 ## Repository Layout
 
@@ -17,80 +17,58 @@ internal/
   registry/                   # Filesystem CRUD over ~/.skern/skills/ and .skern/skills/
   platform/                   # Platform adapters (Claude Code, Codex CLI, OpenCode)
   output/                     # JSON/text structured output formatting
+scripts/
+  install.sh                  # Installer script
+  install_test.sh             # Installer tests
+  smoke_test.sh               # Smoke tests for built binary
+tests/manual/                 # Manual (agent-driven) test scenarios
+docs/                         # Documentation site (VitePress)
 go.mod, go.sum
 Makefile
 .goreleaser.yaml
 .golangci.yml
-.github/workflows/ci.yml
-.github/workflows/release.yml
-scripts/install.sh
+.github/
+  workflows/ci.yml
+  workflows/release.yml
+  workflows/docs-deploy.yml
+  workflows/docs-pr-check.yml
+  CODEOWNERS
 ```
 
-## Build & Run
+## Build, Test & Lint
 
 ```sh
-# Build
-make build
-# or directly:
-go build -o skern ./cmd/skern
-
-# Run
-./skern version
-```
-
-## Testing
-
-```sh
-# Run all tests
-go test ./...
-
-# Run tests for a specific package
-go test ./internal/skill/...
-
-# Run tests with verbose output
-go test -v ./...
-
-# Run tests with coverage
-go test -coverprofile=coverage.out ./...
+make build                  # Build binary with version/commit/date injected
+make test                   # go test ./...
+make test-v                 # Verbose test output
+make test-cover             # Generate coverage report (coverage.out + coverage.html)
+make test-install           # Run installer script tests
+make test-smoke             # Build binary then run smoke tests
+make test-manual-setup      # Set up manual test scenarios
+make test-manual-report     # Report manual test results
+make test-manual-teardown   # Clean up manual test environment
+make lint                   # golangci-lint run
+make fmt                    # gofmt -w .
+make clean                  # Remove binary and coverage files
 ```
 
 Tests use stdlib `testing` + `testify`. Follow table-driven test patterns. Integration tests should use temporary directories to simulate filesystem layouts.
 
-## Linting & Formatting
-
-```sh
-# Format code
-gofmt -w .
-
-# Run linter
-golangci-lint run
-
-# Lint a specific package
-golangci-lint run ./internal/skill/...
-```
-
-Configuration lives in `.golangci.yml`.
+Linter configuration lives in `.golangci.yml`.
 
 ## Issue Tracking Workflow
 
-Development is tracked using **beads-rust (`br`)**, an agent-first CLI issue tracker.
+Development is tracked using **GitHub Issues** via the `gh` CLI.
 
 ```sh
-br list                           # List all open issues
-br ready                          # Show issues ready to work
-br create "Title" --type task     # Create a new issue
-br update <id> --status in_progress
-br close <id> --reason "Done"
-br sync --flush-only              # Export JSONL (then git add .beads/ && git commit)
+gh issue list                             # List open issues
+gh issue create --title "Title" --body "" # Create a new issue
+gh issue view <number>                    # View issue details
+gh issue close <number>                   # Close an issue
+gh issue edit <number> --add-label "bug"  # Add labels
 ```
 
-Each milestone (M0-M6) maps to a `br` epic. Reference issues in commit messages as `br#<id>`.
-
-### Mandatory Workflow
-
-1. **Before starting work**: Create a `br` epic for the milestone and individual issues for each task
-2. **During development**: Update issue status (`in_progress`, `closed`) as work progresses
-3. **In commit messages**: Reference `br#<id>` to link commits to issues
+Reference issues in commit messages as `#<number>` (e.g. `Fix validation edge case (#42)`).
 
 ## Branching Strategy
 
@@ -144,7 +122,7 @@ Each milestone gets its own feature branch. All commits for that milestone go on
 ### Commit Messages
 
 - Keep the subject line concise and imperative ("Add manifest parser", not "Added manifest parser")
-- Reference `br` issues when applicable: `br#<id>`
+- Reference GitHub issues when applicable: `#<number>`
 
 ## Architecture Notes
 
@@ -249,7 +227,7 @@ Names must match `^[a-z0-9]+(-[a-z0-9]+)*$` and be 1-64 characters.
 
 ## Current Status
 
-All milestones (M0–M5) are complete. The project is preparing for its first public release (v0.0.1).
+All milestones (M0–M5) are complete. The first public release (v0.0.1) has shipped.
 
 ### Future Roadmap
 
@@ -264,69 +242,3 @@ These items are tracked as GitHub issues:
 - Skill dependency resolution
 - WASI/Docker execution backends
 
-<!-- br-agent-instructions-v1 -->
-
----
-
-## Beads Workflow Integration
-
-This project uses [beads_rust](https://github.com/Dicklesworthstone/beads_rust) for issue tracking. Issues are stored in `.beads/` and tracked in git.
-
-**Note:** `br` is non-invasive and never executes git commands. After `br sync --flush-only`, you must manually run `git add .beads/ && git commit`.
-
-### Essential Commands
-
-```bash
-# View issues (launches TUI - avoid in automated sessions)
-bv
-
-# CLI commands for agents (use these instead)
-br ready              # Show issues ready to work (no blockers)
-br list --status=open # All open issues
-br show <id>          # Full issue details with dependencies
-br create --title="..." --type=task --priority=2
-br update <id> --status=in_progress
-br close <id> --reason="Completed"
-br close <id1> <id2>  # Close multiple issues at once
-br sync --flush-only  # Export JSONL (does NOT commit)
-git add .beads/
-git commit -m "sync beads"
-```
-
-### Workflow Pattern
-
-1. **Start**: Run `br ready` to find actionable work
-2. **Claim**: Use `br update <id> --status=in_progress`
-3. **Work**: Implement the task
-4. **Complete**: Use `br close <id>`
-5. **Sync**: Run `br sync --flush-only`, then `git add .beads/ && git commit`
-
-### Key Concepts
-
-- **Dependencies**: Issues can block other issues. `br ready` shows only unblocked work.
-- **Priority**: P0=critical, P1=high, P2=medium, P3=low, P4=backlog (use numbers, not words)
-- **Types**: task, bug, feature, epic, question, docs
-- **Blocking**: `br dep add <issue> <depends-on>` to add dependencies
-
-### Session Protocol
-
-**Before ending any session, run this checklist:**
-
-```bash
-git status              # Check what changed
-git add <files>         # Stage code changes
-br sync --flush-only    # Export beads JSONL
-git add .beads/
-git commit -m "..."     # Commit code + beads changes
-git push                # Push to remote
-```
-
-### Best Practices
-
-- Check `br ready` at session start to find available work
-- Update status as you work (in_progress → closed)
-- Create new issues with `br create` when you discover tasks
-- Use descriptive titles and set appropriate priority/type
-- Always `br sync --flush-only` + git add/commit before ending session
-
-<!-- end-br-agent-instructions -->

.beads/issues.jsonl

@@ -1,76 +1,3 @@
-# CLAUDE.md — Skern
+# CLAUDE.md
 
-Skern is a minimal, agent-first CLI for managing Agent Skills across Claude Code, Codex CLI, and OpenCode. It follows the Agent Skills open standard (`SKILL.md` with YAML frontmatter).
-
-## Build & Test
-
-```sh
-make build          # Build binary with version/commit/date injected
-make test           # go test ./...
-make test-v         # Verbose test output
-make test-cover     # Generate coverage report
-make lint           # golangci-lint run
-make fmt            # gofmt -w .
-```
-
-Requires Go 1.23+. Dependencies: `cobra`, `yaml.v3`, `testify`.
-
-## Project Structure
-
-```
-cmd/skern/main.go            # Entry point
-internal/
-  cli/                         # Cobra commands (root, version, init, completion, skill_*, platform_*)
-  skill/                       # Domain: Skill struct, manifest parse/write, validation, scaffolding
-  overlap/                     # Fuzzy name matching (Levenshtein) + description similarity scoring
-  registry/                    # Filesystem CRUD over ~/.skern/skills/ and .skern/skills/
-  platform/                    # Adapters: Claude Code, Codex CLI, OpenCode
-  output/                      # JSON/text output formatting (--json, --quiet)
-```
-
-## Key Commands
-
-```
-skern init                                    # Initialize .skern/ in project
-skern skill create <name> [flags]             # Scaffold SKILL.md
-skern skill list [--scope user|project|all]   # List skills (with dedup hints)
-skern skill show <name>                       # Show skill details
-skern skill search <query>                    # Search by name
-skern skill validate <name>                   # Validate against spec
-skern skill remove <name>                     # Remove from registry
-skern skill install <name> --platform <p>     # Install to platform
-skern skill uninstall <name> --platform <p>   # Uninstall from platform
-skern platform list                           # Show detected platforms
-skern platform status                         # Skill x platform matrix
-skern completion [bash|zsh|fish]              # Shell completions
-```
-
-## Conventions
-
-- All commands support `--json` for machine-readable output
-- Exit codes: 0=success, 1=error, 2=validation failure
-- Skill names: `^[a-z0-9]+(-[a-z0-9]+)*$`, 1-64 chars
-- Tests: table-driven with `testify`, temp dirs via `t.TempDir()`
-- `cli/` package uses injectable `newRegistryFunc` / `newDetectorFunc` for test isolation
-- Errors wrapped with `fmt.Errorf("context: %w", err)`
-- Overlap thresholds: <0.6 proceed, >=0.6 warn, >=0.9 block (override with `--force`)
-
-## Platform Paths
-
-| Platform    | User-level                          | Project-level             |
-|-------------|-------------------------------------|---------------------------|
-| Claude Code | `~/.claude/skills/<name>/`          | `.claude/skills/<name>/`  |
-| Codex CLI   | `~/.agents/skills/<name>/`          | `.agents/skills/<name>/`  |
-| OpenCode    | `~/.config/opencode/skills/<name>/` | `.opencode/skills/<name>/`|
-
-## Issue Tracking
-
-Uses `br` (beads-rust). Milestones map to epics. Reference issues in commits as `br#<id>`.
-
-```sh
-br list               # Open issues
-br create "Title"     # New issue
-br update <id> --status in_progress
-br close <id>
-br sync --flush-only  # Export JSONL (then git add .beads/)
-```
+All agent instructions live in [AGENTS.md](./AGENTS.md). Refer to that file for project overview, build commands, conventions, architecture, and workflow details.

.beads/metadata.json

@@ -42,7 +42,7 @@ skern skill install code-review --platform all
 curl -fsSL https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.sh | bash
 ```
 
-Or with Go 1.23+:
+Or with Go 1.25+:
 
 ```sh
 go install github.com/devrimcavusoglu/skern/cmd/skern@latest

.gitignore

@@ -104,7 +104,7 @@ export default defineConfig({
 
     footer: {
       message: 'Released under the Apache 2.0 License.',
-      copyright: 'Copyright © 2025-present Devrim Cavusoglu',
+      copyright: 'Copyright © 2026-present Devrim Cavusoglu',
     },
   },
 })

AGENTS.md

@@ -11,7 +11,7 @@ cd skern
 
 ## Requirements
 
-- Go 1.23+
+- Go 1.25+
 - `golangci-lint` (for linting)
 - `make`
 
@@ -31,12 +31,12 @@ cd skern
 
 ## Issue Tracking
 
-The project uses `br` (beads-rust) for issue tracking. Reference issues in commits as `br#<id>`.
+The project uses GitHub Issues for tracking. Reference issues in commits as `#<number>`.
 
 ```sh
-br list               # Open issues
-br create "Title"     # New issue
-br close <id>         # Close an issue
+gh issue list                             # List open issues
+gh issue create --title "Title" --body "" # New issue
+gh issue close <number>                   # Close an issue
 ```
 
 ## License