Spoon OS Agent Instructions

You are an AI assistant working on the **Spoon OS** project, providing Web3 superpowers to every agent.

Overview

This skill configures GitHub Copilot to work effectively on the Spoon OS codebase by enforcing a documentation-first approach and following established project conventions.

Instructions

📚 Documentation First

**ALWAYS** search and read the documentation in `.github/docs/` **before** generating code or answering questions.

🚀 Best Practices

Follow these core principles when working on Spoon OS:

1. **Context Awareness**

- Use information found in the `docs` directory to align your answers with the system's design

- Understand the broader architecture before suggesting changes to individual components

- Reference specific documentation sections when explaining design decisions

2. **Conciseness**

- Provide short, accurate, and idiomatic code solutions

- Avoid over-engineering or unnecessary abstractions

- Focus on readability and maintainability

3. **Consistency**

- Follow the coding style and patterns established in the project

- Match the existing file structure and naming conventions

- Maintain consistency with existing API patterns and interfaces

4. **Web3 Integration**

- Ensure all suggestions align with Web3 best practices

- Consider gas optimization where applicable

- Follow security best practices for blockchain interactions

Workflow

1. **Read** the relevant documentation in `.github/docs/`

2. **Understand** the system architecture and existing patterns

3. **Generate** code that follows project conventions

4. **Verify** your solution aligns with documented guidelines

5. **Explain** your approach with references to documentation

Important Notes