move inbox files to proper folders: research, configs, models, skills
This commit is contained in:
@@ -0,0 +1,84 @@
|
||||
# Environment Map
|
||||
|
||||
Discovered: 2026-08-11
|
||||
|
||||
## Platform
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| OS | Debian 13 (trixie) Linux, x86_64 |
|
||||
| Shell | /bin/bash |
|
||||
| User | unprivileged (no sudo) |
|
||||
| Home | /home/user |
|
||||
|
||||
## Runtime
|
||||
|
||||
| Tool | Version |
|
||||
| --- | --- |
|
||||
| Python | 3.12.13 |
|
||||
| Node.js | v22.23.0 |
|
||||
| npm | 10.9.8 |
|
||||
| pnpm | _not installed_ |
|
||||
| Playwright | not globally available (check node_modules) |
|
||||
| Vite | available locally |
|
||||
|
||||
## Auth
|
||||
|
||||
| Service | Status |
|
||||
| --- | --- |
|
||||
| GitHub (`gh`) | ✅ Logged in as `stateofshit` (SSH + token) |
|
||||
| Git config | name: stateofshit · email: [thestateofshit@gmail.com](mailto:thestateofshit@gmail.com) |
|
||||
| SSH keys | none found in ~/.ssh |
|
||||
|
||||
## Directory Structure
|
||||
|
||||
```
|
||||
/home/user/
|
||||
├── 00-incoming/ → raw downloads
|
||||
├── 000-configs/ → tool docs, scripts, Google creds
|
||||
│ ├── GH_CLI_INSTRUCTIONS.md
|
||||
│ ├── PLAYWRIGHT_BROWSER_INSTRUCTIONS.md
|
||||
│ └── VITE_PREVIEW_INSTRUCTIONS.md
|
||||
├── 01-docs/ → documentation
|
||||
├── 02-repos/ → local git clones
|
||||
│ ├── shit_in_a_vault/ ← main Obsidian vault (private, synced)
|
||||
│ ├── superpowers/
|
||||
│ ├── webby/ ← public project
|
||||
│ └── shit_flare/ ← public, Cloudflare
|
||||
├── 03-projects/ → active workspaces
|
||||
│ ├── ai-chat-agent/
|
||||
│ ├── msg-extractor/
|
||||
│ └── rag_project/
|
||||
└── .env.cloudflare ← Cloudflare credentials file
|
||||
```
|
||||
|
||||
## GitHub Repos (7 total)
|
||||
|
||||
| Remote | Private? | Notes |
|
||||
| --- | --- | --- |
|
||||
| stateofshit/shit_in_a_vault | private | Main vault |
|
||||
| stateofshit/shit_flare | public | Cloudflare project |
|
||||
| stateofshit/webby | public | Web project |
|
||||
| stateofshit/bendover-api | private | API |
|
||||
| stateofshit/code | private | General code |
|
||||
| stateofshit/da_vault | private | Another Obsidian vault |
|
||||
| stateofshit/state-shit-backup | private | System defaults backup |
|
||||
|
||||
## Key URLs
|
||||
|
||||
* Vite preview: [https://preview.boogerclub.com](https://preview.boogerclub.com)
|
||||
|
||||
* Vault remote: github.com/stateofshit/shit_in_a_vault
|
||||
|
||||
|
||||
## Missing / Notable
|
||||
|
||||
* No pnpm installed — may need `npm i -g pnpm` or use `npx`
|
||||
|
||||
* No global Playwright binary — check per-project installs
|
||||
|
||||
* No SSH keys — GitHub uses token-based auth via `gh`
|
||||
|
||||
* No Docker access assumed (unprivileged container)
|
||||
|
||||
* Internal services available: `open-webui:8080`, `searxng:8080`
|
||||
@@ -0,0 +1,328 @@
|
||||
```markdown
|
||||
# Master Skills and Tools Documentation
|
||||
|
||||
This document provides a comprehensive overview of all available skills, tools, and directory structures accessible in this technical workspace.
|
||||
|
||||
## Overview
|
||||
|
||||
This workspace is a sophisticated technical environment with extensive capabilities for development, testing, documentation, and system administration. It combines AI-powered development tools with traditional command-line interfaces and version control systems.
|
||||
|
||||
## Knowledge Base Skills
|
||||
|
||||
### Available Skills
|
||||
|
||||
#### 1. **System Processing Skills**
|
||||
|
||||
- **brainstorming-11** (Superpowers Brainstorming SKill)
|
||||
- Purpose: Structured brainstorming and planning methodology
|
||||
- Use case: Initial project planning and concept development
|
||||
|
||||
- **subagent-driven-development-03** (Subagent-Driven Development)
|
||||
- Purpose: Execute plans by dispatching fresh implementer subagents per task with review cycles
|
||||
- Use case: Complex multi-step implementation projects requiring systematic execution
|
||||
|
||||
- **executing-plans-01** (Executing Plans)
|
||||
- Purpose: Load plan, review critically, execute all tasks, report completion
|
||||
- Use case: Planning and execution of structured tasks
|
||||
|
||||
#### 2. **Cloudflare Development Skills**
|
||||
|
||||
- **workers-best-practices** (Workers Best Practices)
|
||||
- Purpose: Reviews and authors Cloudflare Workers code against production best practices
|
||||
- Use case: Cloudflare Workers development and code review
|
||||
|
||||
- **durable-objects** (Durable Objects)
|
||||
- Purpose: Create and review Cloudflare Durable Objects for stateful coordination
|
||||
- Use case: Chat rooms, multiplayer games, booking systems, RPC methods
|
||||
|
||||
- **wrangler** (Wrangler)
|
||||
- Purpose: Cloudflare Workers CLI for deploying, developing, and managing Workers
|
||||
- Use case: Cloudflare Workers deployment and configuration
|
||||
|
||||
- **building-mcp-servers-on-cloudflare-21** (Building MCP Servers)
|
||||
- Purpose: Building MCP servers on Cloudflare with updated SDK knowledge
|
||||
- Use case: MCP server development with Cloudflare integration
|
||||
|
||||
- **building-ai-agent-on-cloudflare** (Building AI Agent)
|
||||
- Purpose: Building AI agents on Cloudflare with updated SDK knowledge
|
||||
- Use case: AI agent development using Cloudflare Agents SDK
|
||||
|
||||
#### 3. **Testing and Performance Skills**
|
||||
|
||||
- **playwright-best-practices** (Playwright Best Practices)
|
||||
- Purpose: Browser testing and screenshot capabilities
|
||||
- Use case: End-to-end testing and visual regression testing
|
||||
|
||||
- **web-perf** (Web Performance)
|
||||
- Purpose: Analyzes web performance using Chrome DevTools
|
||||
- Use case: Web performance auditing and optimization
|
||||
|
||||
#### 4. **Business and User Experience Skills**
|
||||
|
||||
- **solo-dev-fiverr** (Solo Dev Fiverr)
|
||||
- Purpose: Power skill for solo Node/JS/TS dev selling modern dashboard and UI work
|
||||
- Use case: Client deliverables, Fiverr gigs, premium UI development
|
||||
|
||||
- **marketing-psychology** (Marketing Psychology)
|
||||
- Purpose: Apply psychological principles to marketing
|
||||
- Use case: Consumer behavior, persuasion, decision-making optimization
|
||||
|
||||
- **ux-content-formatte-** (UX Content Formatter)
|
||||
- Purpose: Formats text, reports, and dashboard data into scannable layouts
|
||||
- Use case: Content formatting, report generation, data presentation
|
||||
|
||||
#### 5. **Legal and Reference Skills**
|
||||
|
||||
- **courtlistener-api** (Courtlistener API)
|
||||
- Purpose: Legal case law database with PACER data and judge profiles
|
||||
- Use case: Legal research and case law analysis
|
||||
|
||||
#### 6. **Process Skills**
|
||||
|
||||
- **dispatching-parallel-agents-04** (Dispatching Parallel Agents)
|
||||
- Purpose: Delegate tasks to specialized agents with isolated context
|
||||
- Use case: Parallel processing and specialized task execution
|
||||
|
||||
- **find-skills** (Find Skills)
|
||||
- Purpose: Discover and install agent skills
|
||||
- Use case: Skill discovery and capability expansion
|
||||
|
||||
## Available Tools
|
||||
|
||||
### File and Directory Operations
|
||||
|
||||
- **list_files**: Return structured listing of files and directories
|
||||
- **read_file**: Read file contents with optional line ranges and image support
|
||||
- **display_file**: Open files in viewer (for visual inspection)
|
||||
- **write_file**: Write text content to files with automatic directory creation
|
||||
- **replace_file_content**: Find and replace exact strings in files
|
||||
- **view_file**: Get file content by ID with pagination support
|
||||
- **list_processes**: List all tracked background processes
|
||||
|
||||
### Calendar and Scheduling
|
||||
|
||||
- **create_calendar_event**: Create calendar events, reminders, alarms
|
||||
- **search_calendar_events**: Search calendar events by text and date range
|
||||
- **update_calendar_event**: Update existing calendar events
|
||||
- **delete_calendar_event**: Delete calendar events permanently
|
||||
|
||||
### Git and Version Control
|
||||
|
||||
- **run_command**: Run shell commands in background with output tracking
|
||||
- **send_process_input**: Write text to process stdin
|
||||
- **kill_process**: Terminate processes
|
||||
- **get_process_status**: Get process output and status
|
||||
- **list_processes**: List all tracked background processes
|
||||
|
||||
### Knowledge Base Management
|
||||
|
||||
- **list_knowledge**: List knowledge bases, files, and notes
|
||||
- **query_knowledge_files**: Semantic/vector search across knowledge files
|
||||
- **view_knowledge_file**: Get content from knowledge base files
|
||||
- **search_knowledge_files**: Search files by filename across knowledge bases
|
||||
- **grep_knowledge_files**: Exact text search across knowledge files
|
||||
- **write_note**: Create new notes with markdown content
|
||||
- **view_note**: Get full note content by ID
|
||||
- **search_notes**: Search saved notes by title and content
|
||||
- **replace_note_content**: Update existing notes
|
||||
|
||||
### Project Management
|
||||
|
||||
- **create_tasks**: Create visible task checklists for multi-step work
|
||||
- **update_task**: Mark tasks as completed/in_progress/pending/cancelled
|
||||
|
||||
### Documentation Generation
|
||||
|
||||
- **writing-plans**: Create comprehensive implementation plans with task decomposition
|
||||
|
||||
### Automation and Scheduling
|
||||
|
||||
- **create_automation**: Create scheduled automations with iCalendar RRULE
|
||||
- **list_automations**: List scheduled automations
|
||||
- **update_automation**: Update existing automations
|
||||
- **toggle_automation**: Pause/resume automations
|
||||
- **delete_automation**: Delete automations and history
|
||||
|
||||
### Research and Search
|
||||
|
||||
- **search_web**: Search the public web for current information
|
||||
- **deep_research**: Multi-round research using Open WebUI web search
|
||||
- **fetch_url**: Extract main text content from web pages
|
||||
- **consult_council**: Orchestrates 3-stage council meetings
|
||||
|
||||
### Context and Library Management
|
||||
|
||||
- **context7_resolve-library-id**: Resolve package names to Context7-compatible library IDs
|
||||
- **context7_query-docs**: Query up-to-date documentation from Context7
|
||||
|
||||
### Task Delegation
|
||||
|
||||
- **delegate_task**: Delegate focused work to parallel sub-agents
|
||||
- **run_sub_agent**: Delegate tasks to sub-agents for autonomous completion
|
||||
- **run_parallel_sub_agents**: Run multiple independent sub-agent tasks concurrently
|
||||
|
||||
### Time and Utilities
|
||||
|
||||
- **get_current_timestamp**: Get current Unix timestamp
|
||||
- **calculate_timestamp**: Calculate timestamps for date filtering
|
||||
- **timer**: Set one-shot timers
|
||||
|
||||
## Directory Structure
|
||||
|
||||
### Root and Main Directories
|
||||
|
||||
#### `/home/user/000-configs/` - System Configuration
|
||||
|
||||
- **GH_CLI_INSTRUCTIONS.md**: GitHub CLI usage instructions
|
||||
- **PLAYWRIGHT_BROWSER_INSTRUCTIONS.md**: Playwright browser testing instructions
|
||||
- **VITE_PREVIEW_INSTRUCTIONS.md**: Vite development server preview instructions
|
||||
- **docs/**: Documentation folder with internal reference materials
|
||||
- **google/**: Directory for Google-related tools or configurations
|
||||
|
||||
#### `/home/user/02-repos/` - Code Repositories
|
||||
|
||||
- **shit_in_a_vault/**: Private Obsidian vault for note-taking and knowledge management
|
||||
- Contains structured markdown documentation with YAML frontmatter
|
||||
- Used for project documentation and knowledge retention
|
||||
|
||||
- **webby/**: Separate web development project repository
|
||||
- **fuckgovda_vault/**: Previously deleted locally but exists remotely Obsidian vault
|
||||
|
||||
#### `/home/user/02-repos/shit_in_a_vault/` - Obsidian Vault Structure
|
||||
|
||||
**Vault Rules and Configuration:**
|
||||
|
||||
- **04-models/Vault-Rules.md**: Core vault editing rules and conventions
|
||||
- **04-models/model-memory.md**: Historical context and memory
|
||||
- **000-configs/tools/**: Tool documentation and instructions
|
||||
- **01-logs/daily/**: Automated daily notes
|
||||
- **02-notes/**: Short notes, scratch work, per-topic research
|
||||
- **03-archive/**: Completed or superseded materials
|
||||
- **04-models/**: Rules, memory, boot prompt, model identity
|
||||
- **05-handoffs/**: Model-to-model transition materials
|
||||
- **06-research/**: Long-form research with citations
|
||||
- **07-tasks/**: Task tracking files with metadata
|
||||
- **00-assets/**: Attachments and media files
|
||||
|
||||
#### `/home/user/02-repos/shit_in_a_vault/04-models/` - Model Configuration
|
||||
|
||||
- **Vault-Rules.md**: Essential editing rules for all vault files
|
||||
- **model-memory.md**: Historical context and memory
|
||||
- Additional model configuration files may exist
|
||||
|
||||
#### `/home/user/projects/` - Development Projects
|
||||
|
||||
- Local project workspace for development activities
|
||||
- Temporary project directories
|
||||
- Experimentation and prototyping areas
|
||||
|
||||
## Integration and Usage Patterns
|
||||
|
||||
### Knowledge Management Workflow
|
||||
|
||||
1. **Research Phase**: Use `search_web` or `deep_research` for external information
|
||||
2. **Documentation**: Store findings in `02-notes/` or `06-research/` using Obsidian vault structure
|
||||
3. **Reference**: Access knowledge via `query_knowledge_files` or `search_notes`
|
||||
4. **Automation**: Schedule documentation updates using `create_automation`
|
||||
|
||||
### Development Workflow
|
||||
|
||||
1. **Planning**: Use `writing-plans` for comprehensive task breakdown
|
||||
2. **Implementation**: Execute tasks via `executing-plans` or `subagent-driven-development`
|
||||
3. **Testing**: Use `playwright-best-practices` for browser testing
|
||||
4. **Version Control**: Track changes via Git commands and `run_command`
|
||||
|
||||
### System Administration
|
||||
|
||||
1. **Process Management**: Monitor and manage background processes with `list_processes`
|
||||
2. **Calendar Integration**: Schedule tasks and reminders with `create_calendar_event`
|
||||
3. **Documentation Maintenance**: Keep skills and tools updated using `write_file`
|
||||
|
||||
## Capabilities Summary
|
||||
|
||||
### Core Strengths
|
||||
|
||||
- **Comprehensive Documentation**: Extensive tool and skill coverage
|
||||
- **Multi-modal Development**: Supports both AI-powered and traditional development
|
||||
- **Automation Integration**: Full scheduling and automation capabilities
|
||||
- **Knowledge Management**: Sophisticated Obsidian-based documentation system
|
||||
- **Testing Infrastructure**: End-to-end testing with Playwright integration
|
||||
- **Cloud Integration**: Full Cloudflare Workers and Durable Objects support
|
||||
- **Parallel Processing**: Multiple agent capabilities for concurrent development
|
||||
|
||||
### Development Spectrum
|
||||
|
||||
- **Simple Scripts**: Direct command-line execution
|
||||
- **Complex Projects**: Multi-agent, systematic development
|
||||
- **Documentation**: Comprehensive automated documentation generation
|
||||
- **Testing**: Full browser automation and performance analysis
|
||||
- **Deployment**: Cloud deployment with Cloudflare integration
|
||||
|
||||
### Collaboration Features
|
||||
|
||||
- **Task Delegation**: Multiple agent coordination
|
||||
- **Review Cycles**: Systematic review and approval processes
|
||||
- **Documentation**: Comprehensive task and project tracking
|
||||
- **Knowledge Sharing**: Repository-based knowledge management
|
||||
|
||||
## Technical Specifications
|
||||
|
||||
### Environment
|
||||
|
||||
- **Operating System**: Linux 7.0.0-1010-aws (Ubuntu 22.04 base)
|
||||
- **Shell**: bash
|
||||
- **Home Directory**: `/home/user`
|
||||
- **Primary Development Areas**: `/home/user`, `/home/user/projects`, `/home/user/repos`
|
||||
|
||||
### Authentication and Access
|
||||
|
||||
- **SSH Key**: Available for secure connections
|
||||
- **GitHub CLI**: v2.96.0 authenticated as `stateofshit`
|
||||
- **Access Levels**: Multiple access tiers for different environments
|
||||
|
||||
### Available Technologies
|
||||
|
||||
- **Languages**: Node.js, Python 3.12.13, bash
|
||||
- **Frameworks**: Vite, React (preview available at `https://preview.boogerclub.com`)
|
||||
- **Testing**: Playwright browser automation
|
||||
- **Deployment**: Cloudflare Workers integration
|
||||
- **Documentation**: Obsidian vault with markdown and YAML support
|
||||
|
||||
### Preview and Testing
|
||||
|
||||
- **Development Server**: Vite development server with preview at `https://preview.boogerclub.com`
|
||||
- **Browser Testing**: Playwright screenshot and full-page testing capabilities
|
||||
- **Performance Analysis**: Chrome DevTools integration for web performance
|
||||
|
||||
## Usage Recommendations
|
||||
|
||||
### For Beginners
|
||||
|
||||
1. Start with simple tasks using `run_command` for basic operations
|
||||
2. Explore documentation in `/home/user/000-configs/`
|
||||
3. Use `list_files` to understand directory structure
|
||||
4. Begin with `write_note` for simple note-taking
|
||||
|
||||
### For Intermediate Users
|
||||
|
||||
1. Explore `subagent-driven-development-03` for complex projects
|
||||
2. Use `search_web` for external research
|
||||
3. Implement automation with `create_automation`
|
||||
4. Develop comprehensive documentation with `writing-plans`
|
||||
|
||||
### For Advanced Users
|
||||
|
||||
1. Utilize parallel processing with `run_parallel_sub_agents`
|
||||
2. Implement sophisticated workflows with `delegate_task`
|
||||
3. Create complex Cloudflare Workers with `wrangler`
|
||||
4. Build advanced automation systems with `durable-objects`
|
||||
|
||||
## Contact and Support
|
||||
|
||||
For assistance with this system:
|
||||
|
||||
- Refer to specific tool documentation in `/home/user/000-configs/`
|
||||
- Use `search_notes` to find relevant documentation
|
||||
- Consult `context7_query-docs` for library-specific information
|
||||
- Contact through GitHub repositories for code-specific issu
|
||||
```
|
||||
@@ -0,0 +1,74 @@
|
||||
# Superpowers Skill System Overview
|
||||
|
||||
## What is "using-superpowers (bootstrap)"?
|
||||
|
||||
The "using-superpowers (bootstrap)" is the foundational skill in the Superpowers methodology that governs how all other skills are used and accessed.
|
||||
|
||||
## Key Points:
|
||||
|
||||
1. **Foundation Skill**: It establishes the rules for skill invocation before ANY action
|
||||
|
||||
2. **Bootstrap Process**: Automatically injects skill context into every session
|
||||
|
||||
3. **Mandatory Rule**: Skills must be invoked before ANY response, including clarifying questions
|
||||
|
||||
4. **Automatic**: No manual initialization needed - happens automatically via the plugin
|
||||
|
||||
|
||||
## How it works:
|
||||
|
||||
1. The superpowers plugin at `.opencode/plugins/superpowers.js` handles the bootstrap
|
||||
|
||||
2. It discovers and loads all skills from `/home/user/02-repos/superpowers/skills/`
|
||||
|
||||
3. It injects the using-superpowers bootstrap content into the first user message
|
||||
|
||||
4. It makes all superpowers skills discoverable without manual configuration
|
||||
|
||||
|
||||
## Available Skills:
|
||||
|
||||
The system includes 10+ core skills:
|
||||
|
||||
* **brainstorming** - Socratic design refinement
|
||||
|
||||
* **writing-plans** - Detailed implementation plans
|
||||
|
||||
* **executing-plans** - Batch execution with checkpoints
|
||||
|
||||
* **subagent-driven-development** - Fast iteration with review
|
||||
|
||||
* **using-git-worktrees** - Parallel development branches
|
||||
|
||||
* **finishing-a-development-branch** - Merge/PR decision workflow
|
||||
|
||||
* And more...
|
||||
|
||||
|
||||
## Philosophy:
|
||||
|
||||
* **Test-Driven Development** - Write tests first, always
|
||||
|
||||
* **Systematic over ad-hoc** - Process over guessing
|
||||
|
||||
* **Complexity reduction** - Simplicity as primary goal
|
||||
|
||||
* **Evidence over claims** - Verify before declaring success
|
||||
|
||||
|
||||
## Workflow:
|
||||
|
||||
1. **brainstorming** - Activates before writing code
|
||||
|
||||
2. **using-git-worktrees** - Creates isolated workspace
|
||||
|
||||
3. **writing-plans** - Breaks work into tasks
|
||||
|
||||
4. **subagent-driven-development** or **executing-plans** - Executes with reviews
|
||||
|
||||
5. **finishing-a-development-branch** - Completes work
|
||||
|
||||
|
||||
## How to use:
|
||||
|
||||
When starting any conversation, the using-superpowers skill should be invoked first to establish how to find and use skills, with the requirement that skill invocation happens before ANY response.
|
||||
Reference in New Issue
Block a user