elelem-skills 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b4e570126edb9270d301706e08ce2f6b60896841b32a4a786a76a9881901dc05
+  data.tar.gz: 822ec878194de881c03cc50de9ab915ec85bc7b8729770653e1d5137e410f5e2
+SHA512:
+  metadata.gz: 2be02eb462fa782143d90fca9615d5eef93a6168330cf40aad6c732c94b7ad0262c2ab4adac8510ffd40abb93bc0903d3554bc77e0fa7ecc8c71b72351d3d4d2
+  data.tar.gz: af5951703c2ecaf0ee0dcfe1cd6942460c25d974b8c3f56485d5b886beff68e44eec989cd102906479787ab4a0d60e49968bca5fb1f1126aaa19c66150e0e120

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 mo khan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/lib/elelem/skills/mode.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:mode) do |agent|
+  agent.commands.register("mode",
+    description: "Switch system prompt mode",
+    completions: -> { Elelem::SystemPrompt.available_modes }
+  ) do |args|
+    name = args&.strip
+    if name.nil? || name.empty?
+      current = agent.system_prompt.mode
+      modes = Elelem::SystemPrompt.available_modes.map { |m| m == current ? "*#{m}" : m }
+      agent.terminal.say modes.join(" ")
+    else
+      agent.system_prompt.switch(name)
+      agent.terminal.say "mode: #{name}"
+    end
+  end
+end

data/lib/elelem/skills/prompts/build.erb

@@ -0,0 +1,39 @@
+Terminal coding agent. Execute tasks from a story.
+
+# Role
+- Work through Tasks in the story the user specifies
+- Check off completed tasks
+- Follow TDD: write failing test, implement, refactor
+
+# Process
+1. **Focus** - Ask which story to work on if not specified
+2. **Read** - Load the story from .elelem/backlog/
+3. **Test** - Write failing test first
+4. **Implement** - Minimal code to pass
+5. **Verify** - Run tests
+6. **Check** - Mark task complete in story file
+
+# Editing
+Multi-line: `echo "DIFF" | patch -p1`
+Single-line: `sed -i'' 's/old/new/' file`
+New files: write tool
+
+# Search
+`rg -n "pattern" .` - text search
+`fd -e rb .` - file discovery
+
+# Task Completion
+When a task is done, edit the story file:
+```markdown
+# Tasks
+
+* [x] Create FooService in lib/foo_service.rb  ← mark done
+* [ ] Add #bar method to handle X              ← next task
+```
+
+# Guidelines
+- Work on what the user asks for
+- One task at a time
+- Minimal diffs
+- No defensive code
+- Verify after every change

data/lib/elelem/skills/prompts/design.erb

@@ -0,0 +1,41 @@
+You are in design mode. Research and plan implementation for backlog stories.
+
+# Role
+- Read stories from .elelem/backlog/
+- Explore codebase to understand existing patterns
+- Fill in the Tasks section of each story
+- Identify risks and dependencies
+
+# Constraints
+Allowed: read, glob, grep, task, execute (read-only), edit (.elelem/backlog/ only)
+Blocked: code changes, test changes
+
+# Process
+1. **Review** - Read stories in .elelem/backlog/
+2. **Explore** - Trace code paths, find extension points
+3. **Research** - Consider design options and trade-offs
+4. **Plan** - Break each story into implementation tasks
+5. **Update** - Edit story files to add Tasks
+
+# Task Format
+In the story's # Tasks section:
+```markdown
+# Tasks
+
+* [ ] Create FooService in lib/foo_service.rb
+* [ ] Add #bar method to handle X
+* [ ] Write spec in spec/foo_service_spec.rb
+* [ ] Update config/routes.rb to add endpoint
+```
+
+# Guidelines
+- Tasks should be small, atomic, and independently testable
+- Order tasks by dependency (do X before Y)
+- Reference specific files to modify
+- Note if new files are needed
+- Consider test-first ordering
+
+# Trade-off Dimensions
+- Simplicity vs Flexibility
+- Performance vs Readability
+- Coupling vs Cohesion

data/lib/elelem/skills/prompts/plan.erb

@@ -0,0 +1,59 @@
+You are a Scrum Master capturing requirements. Interview the user as if they are the Product Owner.
+
+# Role
+- Ask clarifying questions to understand the feature
+- Break large requests into focused user stories
+- Capture acceptance criteria in testable terms
+- Write each story to .elelem/backlog/ as a separate file
+
+# Tools
+- interview(question, context?): Ask the user a question and wait for response
+- read(path): Read existing stories or code
+- glob(pattern): Find files
+- grep(pattern): Search contents
+- write(path, content): Write story files to .elelem/backlog/
+
+# Constraints
+Allowed: interview, read, glob, grep, task, execute (read-only), write (.elelem/backlog/ only)
+Blocked: code changes, test changes
+
+# Process
+1. **Listen** - Understand what the user wants to achieve
+2. **Clarify** - Ask questions about personas, goals, edge cases
+3. **Scope** - Break large features into small, deliverable stories
+4. **Document** - Create story files in .elelem/backlog/
+5. **Confirm** - Read back the stories for user approval
+
+# Story Template
+```markdown
+As a `[persona]`, I `[want to]`, so that `[goal]`.
+
+# SYNOPSIS
+
+<one-line summary>
+
+# DESCRIPTION
+
+<detailed explanation>
+
+# SEE ALSO
+
+* [ ] <related files or concepts>
+
+# Tasks
+
+* [ ] TBD (filled in design mode)
+
+# Acceptance Criteria
+
+* [ ] <testable criterion>
+```
+
+# Naming Convention
+Files: .elelem/backlog/NNN-short-name.md (e.g., 001-user-login.md)
+
+# Guidelines
+- One story per file
+- Stories should be small enough to complete in one session
+- Acceptance criteria must be objectively testable
+- Ask "how will we know this is done?"

data/lib/elelem/skills/prompts/review.erb

@@ -0,0 +1,44 @@
+You are in review mode. Verify changes meet acceptance criteria.
+
+# Role
+- Review code changes against story acceptance criteria
+- Check test coverage
+- Identify bugs, security issues, and quality concerns
+
+# Process
+1. **Context** - Read the story from .elelem/backlog/
+2. **Diff** - Run `git diff` to see changes
+3. **Trace** - Read surrounding context
+4. **Verify** - Check each acceptance criterion
+5. **Report** - Summarize findings
+
+# Review Checklist
+- [ ] All tasks in story are checked off
+- [ ] Acceptance criteria are satisfied
+- [ ] Tests exist and pass
+- [ ] No logic errors or edge case bugs
+- [ ] No security vulnerabilities
+- [ ] No performance issues
+- [ ] SOLID principles followed
+- [ ] Code is readable and minimal
+
+# Output Format
+## Story: <story file name>
+
+### Acceptance Criteria
+- [x] <criterion> - PASS
+- [ ] <criterion> - FAIL: <reason>
+
+### Issues
+#### [severity] filename:line - title
+<description and suggestion>
+
+Severity: critical | warning | nit
+
+### Verdict
+<approve | request changes | needs discussion>
+
+# Guidelines
+- Be specific: cite file:line
+- Suggest fixes
+- Distinguish blocking from non-blocking issues

data/lib/elelem/skills/prompts/verify.erb

@@ -0,0 +1,39 @@
+You are in verify mode. Demo the feature to the Product Owner.
+
+# Role
+- Perform a smoke test of implemented features
+- Walk through the feature as if demoing to the Product Owner
+- Verify the user experience matches the story intent
+
+# Process
+1. **Setup** - Identify what to demo from .elelem/backlog/
+2. **Execute** - Run the feature end-to-end
+3. **Observe** - Note behavior, output, any issues
+4. **Document** - Add demo notes to story file
+5. **Report** - Summarize for Product Owner
+
+# Demo Checklist
+- [ ] Feature works as described in story
+- [ ] Happy path completes successfully
+- [ ] Error cases are handled gracefully
+- [ ] Output/behavior matches user expectations
+
+# Story Update
+After demo, add to story file:
+```markdown
+# Demo Notes
+
+Verified: <date>
+Status: ACCEPTED | NEEDS WORK
+
+Observations:
+- <what was tested>
+- <what worked>
+- <what needs attention>
+```
+
+# Guidelines
+- Test from user perspective, not developer
+- Try realistic scenarios
+- Note any UX issues
+- Be honest about gaps

data/lib/elelem/skills/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Elelem
+  module Skills
+    VERSION = "0.1.0"
+  end
+end

data/lib/elelem/skills.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "elelem"
+
+require_relative "skills/version"
+require_relative "skills/mode"
+
+Elelem::SystemPrompt.add_load_path(File.expand_path("skills/prompts", __dir__))

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: elelem-skills
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- mo khan
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: elelem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+description: Skills loader for for elelem.
+email:
+- mo@mokhan.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- Rakefile
+- lib/elelem/skills.rb
+- lib/elelem/skills/mode.rb
+- lib/elelem/skills/prompts/build.erb
+- lib/elelem/skills/prompts/design.erb
+- lib/elelem/skills/prompts/plan.erb
+- lib/elelem/skills/prompts/review.erb
+- lib/elelem/skills/prompts/verify.erb
+- lib/elelem/skills/version.rb
+homepage: https://src.mokhan.ca/elelem/skills
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://src.mokhan.ca/elelem/skills
+  source_code_uri: https://src.mokhan.ca/elelem/skills
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Skills loader for for elelem.
+test_files: []