takomi 2.0.4

package/assets/.agent/skills/nextjs-standards/templates/Issue_Template.md

@@ -0,0 +1,194 @@
+# Issue Template
+
+Use this format for all GitHub Issues created during Genesis.
+
+---
+
+## Template
+
+```markdown
+# [FR-XXX] Feature Title
+
+## Labels
+`MUS`, `enhancement`, `[module-name]`
+
+## User Story
+As a [user type], I want to [action], so that [benefit].
+
+## Proposed Solution
+
+### Overview
+Brief description of the approach.
+
+### Implementation Flow
+1. **Step One** — What happens first
+2. **Step Two** — What happens next
+3. **Step Three** — Final step
+
+### Technical Approach
+
+```[language]
+// Suggested implementation pattern
+// This is GUIDANCE, not gospel — adapt as architecture evolves
+
+// Example function signatures
+export function doSomething(input: InputType): OutputType { ... }
+```
+
+### Key Considerations
+- Important point 1
+- Important point 2
+- Edge case to handle
+
+## Acceptance Criteria
+
+- [ ] Testable outcome 1
+- [ ] Testable outcome 2
+- [ ] Testable outcome 3
+```
+
+---
+
+## Guidelines
+
+### User Story
+- Keep it simple: As a WHO, I want WHAT, so that WHY
+- Focus on the user's goal, not implementation details
+
+### Proposed Solution
+- **Overview**: 1-2 sentences explaining the approach
+- **Implementation Flow**: High-level steps in plain English
+- **Technical Approach**: Code patterns that GUIDE but don't dictate
+- **Key Considerations**: Edge cases, potential issues, design decisions
+
+### Acceptance Criteria
+- Each item should be independently testable
+- Use checkboxes `- [ ]` so agents can mark completion
+- Focus on observable outcomes, not implementation steps
+
+---
+
+## Examples
+
+### Simple UI Feature
+
+```markdown
+# [FR-003] User Profile Page
+
+## Labels
+`MUS`, `enhancement`, `users`
+
+## User Story
+As a user, I want to view my profile, so that I can see my account information.
+
+## Proposed Solution
+
+### Overview
+Create a profile page at `/profile` that displays user info from the session.
+
+### Implementation Flow
+1. Create `/app/profile/page.tsx` as a Server Component
+2. Fetch user data from session
+3. Display name, email, and role
+
+### Technical Approach
+
+```tsx
+// app/profile/page.tsx
+export default async function ProfilePage() {
+  const session = await getSession();
+  if (!session) redirect('/login');
+  
+  return <ProfileCard user={session.user} />;
+}
+```
+
+### Key Considerations
+- Handle unauthenticated users (redirect to login)
+- Consider adding edit functionality later
+
+## Acceptance Criteria
+
+- [ ] Profile page exists at /profile
+- [ ] Shows user name and email
+- [ ] Redirects to login if not authenticated
+```
+
+### Complex Backend Feature
+
+```markdown
+# [FR-007] Payment Processing
+
+## Labels
+`MUS`, `enhancement`, `payments`, `critical`
+
+## User Story
+As an admin, I want to process payments, so that team members get paid.
+
+## Proposed Solution
+
+### Overview
+Integrate with Paystack to process payouts to team members.
+
+### Implementation Flow
+1. Create Paystack service for API calls
+2. Create transfer recipients from bank details
+3. Initiate bulk transfers for approved payouts
+4. Handle webhook callbacks for status updates
+
+### Technical Approach
+
+```typescript
+// features/payments/paystack.service.ts
+export const paystackService = {
+  async createRecipient(bankDetails: BankDetails) { ... },
+  async initiateTransfer(recipientCode: string, amount: number) { ... },
+  async handleWebhook(event: PaystackEvent) { ... }
+};
+```
+
+### Key Considerations
+- Store Paystack recipient codes to avoid re-creating
+- Handle failed transfers gracefully
+- Verify webhook signatures for security
+- Test mode vs live mode handling
+
+## Acceptance Criteria
+
+- [ ] Can create transfer recipients
+- [ ] Can initiate single transfer
+- [ ] Can initiate bulk transfers
+- [ ] Webhook updates payout status
+- [ ] Failed transfers are logged and retryable
+```
+
+---
+
+## File Structure
+
+**One Issue Per File** — Each FR gets its own file for GitHub ops compatibility.
+
+```
+docs/issues/
+├── FR-001.md    # One file per FR
+├── FR-002.md
+├── FR-003.md
+└── ...
+```
+
+### Sub-Issues (Optional)
+
+If an FR is complex, the Genesis agent can create sub-issues within the same directory:
+
+```
+docs/issues/
+├── FR-001.md           # Main issue
+├── FR-001-a.md         # Sub-issue A (optional)
+├── FR-001-b.md         # Sub-issue B (optional)
+└── ...
+```
+
+Sub-issues should:
+- Reference the parent: `## Parent: FR-001`
+- Be smaller, focused tasks
+- Still have their own acceptance criteria

package/assets/.agent/skills/optimize-agent-context/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: optimize-agent-context
+description: >
+  Create, audit, or optimize agent.md, claude.md, cursorrules, or any AI coding agent context file
+  using the "Band-Aid Philosophy." Strips bloat, enforces minimalism, and ensures only failure-correcting
+  rules remain. Use when the user mentions: "agent.md", "claude.md", "cursorrules", ".clinerules",
+  "AGENTS.md", "context file", "optimize context", "agent instructions", "reduce agent bloat",
+  "agent keeps making mistakes", "fix my agent file", "create agent file", "audit agent context",
+  or any variant of writing/improving AI coding agent instruction files.
+---
+
+# Optimize Agent Context
+
+Enforce the **Band-Aid Philosophy**: an agent context file should only contain rules that fix mistakes the agent is actively making. Everything else is bloat that degrades performance and increases cost.
+
+## Core Rules (Non-Negotiable)
+
+1. **NO BLOAT** — Never include directory structures, file trees, dependency lists, or package inventories. The agent has tools to discover these.
+2. **NO SUMMARIES** — Never include vague app descriptions ("This is a video sharing app"). This distracts the model and triggers hallucinations.
+3. **ONLY FIX KNOWN FAILURES** — Every line must correct a specific, observed agent mistake or enforce an architectural constraint the agent cannot guess.
+4. **USE NEGATIVE CONSTRAINTS** — When the agent uses the wrong tool/library, explicitly state what NOT to use, then what TO use.
+5. **BE MINIMAL** — Target under 20 lines. Bullet points preferred. If a rule can be removed without the agent breaking, remove it.
+
+## Why This Matters
+
+Studies show bloated, AI-generated context files:
+- **Degrade agent performance by ~3%**
+- **Increase token costs by 20%+**
+- Trigger hallucinations by surfacing legacy code the agent then tries to use ("pink elephants" effect)
+
+## Workflow
+
+### Mode A: Create New Agent File (Interview)
+
+When the user wants to create a new context file from scratch:
+
+1. **Ask these questions one at a time** (do not dump all at once):
+   - "What specific mistakes has the AI agent been making repeatedly?" (e.g., wrong imports, forgetting to format, modifying wrong files)
+   - "Are there legacy tools/libraries the agent keeps using but shouldn't?" (e.g., "We have Redux but use Zustand for new features")
+   - "Any build/test/env quirks the agent can't figure out on its own?" (e.g., special env vars, non-standard test commands)
+
+2. **Synthesize** answers into a ruthlessly minimal bulleted markdown file.
+
+3. **Validate** the output against the Core Rules above. Strip anything that violates them.
+
+4. **Present** the file and ask: "Does this capture the mistakes? Anything to add or remove?"
+
+### Mode B: Audit Existing Agent File
+
+When the user has an existing `agent.md` / `claude.md` / `cursorrules` and wants it optimized:
+
+1. **Read the file** using `view_file`.
+2. **Classify every line** into one of:
+   - ✅ **KEEP** — Fixes a known failure or states an ungessable constraint
+   - ❌ **BLOAT** — Directory trees, dependency lists, file structures
+   - ❌ **SUMMARY** — Vague app descriptions, project overviews
+   - ❌ **OBVIOUS** — Things the agent can discover via tools (package.json, tsconfig, etc.)
+   - ⚠️ **MAYBE** — Potentially useful but needs user confirmation
+3. **Present the audit** as a table showing each section and its classification.
+4. **Generate the optimized version** with only ✅ KEEP and confirmed ⚠️ MAYBE lines.
+5. **Show before/after line count** to demonstrate the reduction.
+
+### Mode C: Add a Band-Aid
+
+When the user reports a specific agent mistake mid-session:
+
+1. Ask: "What did the agent do wrong?"
+2. Write a single, precise negative constraint: `Do NOT [wrong thing]. Instead, [correct thing].`
+3. Suggest appending it to the existing context file.
+
+## Output Format
+
+The generated file should follow this structure:
+
+```markdown
+# Agent Rules
+
+- [Negative constraint or correction]
+- [Negative constraint or correction]
+- [Build/test quirk]
+- [Architectural constraint]
+```
+
+**No headers beyond the title. No explanations. No examples. Just rules.**
+
+## Anti-Patterns to Reject
+
+If the user or another agent tries to include any of these, push back:
+
+| Anti-Pattern | Why It's Bad |
+|---|---|
+| Folder tree / file structure | Agent has `list_dir` and `find_by_name` |
+| Dependency list | Agent reads `package.json` / `requirements.txt` |
+| "This app is a..." summary | Distracts model, triggers hallucination |
+| Tech stack overview | Agent reads config files |
+| Code style rules already in linter config | Redundant — linter enforces these |
+| Long code examples | Bloats context, agent writes its own code |

package/assets/.agent/skills/pdf/LICENSE.txt

@@ -0,0 +1,30 @@
+© 2025 Anthropic, PBC. All rights reserved.
+
+LICENSE: Use of these materials (including all code, prompts, assets, files,
+and other components of this Skill) is governed by your agreement with
+Anthropic regarding use of Anthropic's services. If no separate agreement
+exists, use is governed by Anthropic's Consumer Terms of Service or
+Commercial Terms of Service, as applicable:
+https://www.anthropic.com/legal/consumer-terms
+https://www.anthropic.com/legal/commercial-terms
+Your applicable agreement is referred to as the "Agreement." "Services" are
+as defined in the Agreement.
+
+ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the
+contrary, users may not:
+
+- Extract these materials from the Services or retain copies of these
+  materials outside the Services
+- Reproduce or copy these materials, except for temporary copies created
+  automatically during authorized use of the Services
+- Create derivative works based on these materials
+- Distribute, sublicense, or transfer these materials to any third party
+- Make, offer to sell, sell, or import any inventions embodied in these
+  materials
+- Reverse engineer, decompile, or disassemble these materials
+
+The receipt, viewing, or possession of these materials does not convey or
+imply any license or right beyond those expressly granted above.
+
+Anthropic retains all right, title, and interest in these materials,
+including all copyrights, patents, and other intellectual property rights.

package/assets/.agent/skills/pdf/SKILL.md

@@ -0,0 +1,314 @@
+---
+name: pdf
+description: Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
+license: Proprietary. LICENSE.txt has complete terms
+---
+
+# PDF Processing Guide
+
+## Overview
+
+This guide covers essential PDF processing operations using Python libraries and command-line tools. For advanced features, JavaScript libraries, and detailed examples, see REFERENCE.md. If you need to fill out a PDF form, read FORMS.md and follow its instructions.
+
+## Quick Start
+
+```python
+from pypdf import PdfReader, PdfWriter
+
+# Read a PDF
+reader = PdfReader("document.pdf")
+print(f"Pages: {len(reader.pages)}")
+
+# Extract text
+text = ""
+for page in reader.pages:
+    text += page.extract_text()
+```
+
+## Python Libraries
+
+### pypdf - Basic Operations
+
+#### Merge PDFs
+```python
+from pypdf import PdfWriter, PdfReader
+
+writer = PdfWriter()
+for pdf_file in ["doc1.pdf", "doc2.pdf", "doc3.pdf"]:
+    reader = PdfReader(pdf_file)
+    for page in reader.pages:
+        writer.add_page(page)
+
+with open("merged.pdf", "wb") as output:
+    writer.write(output)
+```
+
+#### Split PDF
+```python
+reader = PdfReader("input.pdf")
+for i, page in enumerate(reader.pages):
+    writer = PdfWriter()
+    writer.add_page(page)
+    with open(f"page_{i+1}.pdf", "wb") as output:
+        writer.write(output)
+```
+
+#### Extract Metadata
+```python
+reader = PdfReader("document.pdf")
+meta = reader.metadata
+print(f"Title: {meta.title}")
+print(f"Author: {meta.author}")
+print(f"Subject: {meta.subject}")
+print(f"Creator: {meta.creator}")
+```
+
+#### Rotate Pages
+```python
+reader = PdfReader("input.pdf")
+writer = PdfWriter()
+
+page = reader.pages[0]
+page.rotate(90)  # Rotate 90 degrees clockwise
+writer.add_page(page)
+
+with open("rotated.pdf", "wb") as output:
+    writer.write(output)
+```
+
+### pdfplumber - Text and Table Extraction
+
+#### Extract Text with Layout
+```python
+import pdfplumber
+
+with pdfplumber.open("document.pdf") as pdf:
+    for page in pdf.pages:
+        text = page.extract_text()
+        print(text)
+```
+
+#### Extract Tables
+```python
+with pdfplumber.open("document.pdf") as pdf:
+    for i, page in enumerate(pdf.pages):
+        tables = page.extract_tables()
+        for j, table in enumerate(tables):
+            print(f"Table {j+1} on page {i+1}:")
+            for row in table:
+                print(row)
+```
+
+#### Advanced Table Extraction
+```python
+import pandas as pd
+
+with pdfplumber.open("document.pdf") as pdf:
+    all_tables = []
+    for page in pdf.pages:
+        tables = page.extract_tables()
+        for table in tables:
+            if table:  # Check if table is not empty
+                df = pd.DataFrame(table[1:], columns=table[0])
+                all_tables.append(df)
+
+# Combine all tables
+if all_tables:
+    combined_df = pd.concat(all_tables, ignore_index=True)
+    combined_df.to_excel("extracted_tables.xlsx", index=False)
+```
+
+### reportlab - Create PDFs
+
+#### Basic PDF Creation
+```python
+from reportlab.lib.pagesizes import letter
+from reportlab.pdfgen import canvas
+
+c = canvas.Canvas("hello.pdf", pagesize=letter)
+width, height = letter
+
+# Add text
+c.drawString(100, height - 100, "Hello World!")
+c.drawString(100, height - 120, "This is a PDF created with reportlab")
+
+# Add a line
+c.line(100, height - 140, 400, height - 140)
+
+# Save
+c.save()
+```
+
+#### Create PDF with Multiple Pages
+```python
+from reportlab.lib.pagesizes import letter
+from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
+from reportlab.lib.styles import getSampleStyleSheet
+
+doc = SimpleDocTemplate("report.pdf", pagesize=letter)
+styles = getSampleStyleSheet()
+story = []
+
+# Add content
+title = Paragraph("Report Title", styles['Title'])
+story.append(title)
+story.append(Spacer(1, 12))
+
+body = Paragraph("This is the body of the report. " * 20, styles['Normal'])
+story.append(body)
+story.append(PageBreak())
+
+# Page 2
+story.append(Paragraph("Page 2", styles['Heading1']))
+story.append(Paragraph("Content for page 2", styles['Normal']))
+
+# Build PDF
+doc.build(story)
+```
+
+#### Subscripts and Superscripts
+
+**IMPORTANT**: Never use Unicode subscript/superscript characters (₀₁₂₃₄₅₆₇₈₉, ⁰¹²³⁴⁵⁶⁷⁸⁹) in ReportLab PDFs. The built-in fonts do not include these glyphs, causing them to render as solid black boxes.
+
+Instead, use ReportLab's XML markup tags in Paragraph objects:
+```python
+from reportlab.platypus import Paragraph
+from reportlab.lib.styles import getSampleStyleSheet
+
+styles = getSampleStyleSheet()
+
+# Subscripts: use <sub> tag
+chemical = Paragraph("H<sub>2</sub>O", styles['Normal'])
+
+# Superscripts: use <super> tag
+squared = Paragraph("x<super>2</super> + y<super>2</super>", styles['Normal'])
+```
+
+For canvas-drawn text (not Paragraph objects), manually adjust font the size and position rather than using Unicode subscripts/superscripts.
+
+## Command-Line Tools
+
+### pdftotext (poppler-utils)
+```bash
+# Extract text
+pdftotext input.pdf output.txt
+
+# Extract text preserving layout
+pdftotext -layout input.pdf output.txt
+
+# Extract specific pages
+pdftotext -f 1 -l 5 input.pdf output.txt  # Pages 1-5
+```
+
+### qpdf
+```bash
+# Merge PDFs
+qpdf --empty --pages file1.pdf file2.pdf -- merged.pdf
+
+# Split pages
+qpdf input.pdf --pages . 1-5 -- pages1-5.pdf
+qpdf input.pdf --pages . 6-10 -- pages6-10.pdf
+
+# Rotate pages
+qpdf input.pdf output.pdf --rotate=+90:1  # Rotate page 1 by 90 degrees
+
+# Remove password
+qpdf --password=mypassword --decrypt encrypted.pdf decrypted.pdf
+```
+
+### pdftk (if available)
+```bash
+# Merge
+pdftk file1.pdf file2.pdf cat output merged.pdf
+
+# Split
+pdftk input.pdf burst
+
+# Rotate
+pdftk input.pdf rotate 1east output rotated.pdf
+```
+
+## Common Tasks
+
+### Extract Text from Scanned PDFs
+```python
+# Requires: pip install pytesseract pdf2image
+import pytesseract
+from pdf2image import convert_from_path
+
+# Convert PDF to images
+images = convert_from_path('scanned.pdf')
+
+# OCR each page
+text = ""
+for i, image in enumerate(images):
+    text += f"Page {i+1}:\n"
+    text += pytesseract.image_to_string(image)
+    text += "\n\n"
+
+print(text)
+```
+
+### Add Watermark
+```python
+from pypdf import PdfReader, PdfWriter
+
+# Create watermark (or load existing)
+watermark = PdfReader("watermark.pdf").pages[0]
+
+# Apply to all pages
+reader = PdfReader("document.pdf")
+writer = PdfWriter()
+
+for page in reader.pages:
+    page.merge_page(watermark)
+    writer.add_page(page)
+
+with open("watermarked.pdf", "wb") as output:
+    writer.write(output)
+```
+
+### Extract Images
+```bash
+# Using pdfimages (poppler-utils)
+pdfimages -j input.pdf output_prefix
+
+# This extracts all images as output_prefix-000.jpg, output_prefix-001.jpg, etc.
+```
+
+### Password Protection
+```python
+from pypdf import PdfReader, PdfWriter
+
+reader = PdfReader("input.pdf")
+writer = PdfWriter()
+
+for page in reader.pages:
+    writer.add_page(page)
+
+# Add password
+writer.encrypt("userpassword", "ownerpassword")
+
+with open("encrypted.pdf", "wb") as output:
+    writer.write(output)
+```
+
+## Quick Reference
+
+| Task | Best Tool | Command/Code |
+|------|-----------|--------------|
+| Merge PDFs | pypdf | `writer.add_page(page)` |
+| Split PDFs | pypdf | One page per file |
+| Extract text | pdfplumber | `page.extract_text()` |
+| Extract tables | pdfplumber | `page.extract_tables()` |
+| Create PDFs | reportlab | Canvas or Platypus |
+| Command line merge | qpdf | `qpdf --empty --pages ...` |
+| OCR scanned PDFs | pytesseract | Convert to image first |
+| Fill PDF forms | pdf-lib or pypdf (see FORMS.md) | See FORMS.md |
+
+## Next Steps
+
+- For advanced pypdfium2 usage, see REFERENCE.md
+- For JavaScript libraries (pdf-lib), see REFERENCE.md
+- If you need to fill out a PDF form, follow the instructions in FORMS.md
+- For troubleshooting guides, see REFERENCE.md