Skip to content

Latest commit

 

History

History
35 lines (26 loc) · 1.75 KB

AGENTS.md

File metadata and controls

35 lines (26 loc) · 1.75 KB

Project Instructions

Purpose

This repository supports a hackathon project for Agents, Everywhere: Bots, Channels, & More. Help the team ideate, choose, scope, build, test, and pitch one strong embedded-agent experience.

Product principles

  • The agent must live where people already work, talk, or live.
  • The environment must provide context, triggers, relationships, or actions that materially change the agent's behaviour.
  • Reject concepts that are essentially standalone chatbots or generic retrieval systems in a different wrapper.
  • Prefer one reliable, memorable end-to-end workflow over broad scope.
  • Treat human visibility, steering, approval, and decision authority as core interaction design.
  • Map sponsor technology to a chosen behaviour; do not let available technology generate the concept by itself.
  • Design for a roughly three-hour effective build and a clear two-minute demo.

Working practices

  • Read project-documents/01-hackathon-brief.md before evaluating major product choices.
  • Keep raw source material separate from interpretation and decisions.
  • Record material product or technical decisions in project-documents/05-decisions-log.md.
  • Put exploratory alternatives in project-documents/03-idea-exploration.md.
  • Once a concept is selected, maintain its source of truth in project-documents/concept/.
  • State assumptions and uncertainty explicitly.
  • Critique weak ideas candidly and score concepts consistently against the judging criteria.
  • Protect working code and unrelated teammate changes. Avoid broad rewrites during the build window.

Definition of success

The project should answer all four questions convincingly:

  1. Does it work?
  2. Does it belong in this environment?
  3. Is it technically real?
  4. Is it actually useful?