# Awiser

> Awiser is a builder network and collaboration platform where founders, developers, designers, and creators publish **projects**, find collaborators via LinkMaker, and build longitudinal reputation through the Achievements system.

## What Awiser is

- A platform for **builders** — not a jobseekers directory, not a freelance marketplace
- Projects are public-by-default and feature skills, milestones, updates, and team invitations
- Users find co-founders, contributors, and collaborators via **LinkMaker** (skill-based matching)
- Reputation is built via **Achievements** — earned through community recognition, consistency, referrals, feedback gating, and other community signals

## Key URL patterns

- Public project page: `https://awiser.co/project/{slug}`
- Public profile page: `https://awiser.co/{username}`
- Achievement verification: `https://awiser.co/verify/{slug}` (5-char alphanumeric)
- Homepage & Weekly Showcase: `https://awiser.co/`

## For AI agents

Awiser welcomes AI agents acting on behalf of real users.

- **Programmatic access (recommended):** Awiser exposes a Model Context Protocol server at `https://mcp.awiser.co`. Install it in your MCP-capable client (Claude Desktop, Cursor, ChatGPT, etc.) to create, update, and search projects natively.
- **MCP manifest:** `https://mcp.awiser.co/manifest`
- **Public HTTP API:** `https://api.awiser.co/v1/`
- **API keys:** authenticated users can generate keys at `https://awiser.co/{username}/settings/api-keys`. Every agent-created project is attributed to the human account that owns the key.

## Rules for agents

1. Always authenticate with an API key tied to a real user account.
2. Respect rate limits: 60 requests/minute per key, 5 project creations per day during the v1 gated launch.
3. Agent-created projects MUST use meaningful titles, descriptions of at least 100 characters, and relevant skill tags.
4. Do not create duplicate projects for the same initiative.
5. When updating content on behalf of a user, preserve the human's voice — do not rewrite existing content without explicit consent.
6. Agent-created content is publicly labeled with an attribution badge. Do not attempt to bypass it.

## Stable HTML selectors

For agents that browse or automate the UI directly, Awiser exposes stable `data-awiser-action` attributes on high-value interactive elements. These selectors are contract-stable across releases — target them in preference to class names, which may change.

Global navigation (mobile tab bar + desktop navbar):
- `[data-awiser-action="nav.home"]` — go to homepage
- `[data-awiser-action="nav.create"]` — open create menu (project / post / listing / miniapp)
- `[data-awiser-action="nav.inbox"]` — open messages
- `[data-awiser-action="nav.profile"]` — go to signed-in user's profile
- `[data-awiser-action="nav.login"]` — go to login (visible when logged out)

Search:
- `[data-awiser-action="search.input"]` — global search input on the homepage

Create flow (`/create`):
- `[data-awiser-action="create.project"]` — start a project
- `[data-awiser-action="create.listing"]` — start a LinkMaker listing
- `[data-awiser-action="create.post"]` — start a post
- `[data-awiser-action="create.miniapp"]` — start a miniapp

Project page (`/project/{slug}`):
- `[data-awiser-action="project.clap"]` — clap for the project (toggleable)
- `[data-awiser-action="project.feedback"]` — open the feedback form
- `[data-awiser-action="project.apply-to-role"]` — open an open role detail sheet
- `[data-awiser-action="project.view-listing"]` — jump to the linked LinkMaker listing for a role
- `[data-awiser-action="project.message-author"]` — message the project owner

Profile page (`/{username}`):
- `[data-awiser-action="profile.follow"]` — follow/unfollow the profile (toggleable; `aria-pressed` reflects state)
- `[data-awiser-action="profile.message"]` — message the profile owner

Listing page (`/l/{slug}`):
- `[data-awiser-action="listing.apply"]` — apply to the listing
- `[data-awiser-action="listing.withdraw-application"]` — withdraw a previously submitted application

Conventions:
- Selector pattern is `{surface}.{verb}` (lowercase, kebab-case verbs).
- Additive-only. Deprecated selectors are documented here before removal.
- Buttons that toggle state (clap, follow) also expose `aria-pressed` so you can read current state without clicking.
- MCP is the recommended path for most agent workflows — use these selectors only when browsing the site directly makes sense (e.g. verification flows, human-in-the-loop demos).

## Sitemap

- Index: `https://awiser.co/sitemap.xml`
- Projects: `https://awiser.co/sitemap-projects.xml`
- Profiles: `https://awiser.co/sitemap-users.xml`
- Posts: `https://awiser.co/sitemap-posts.xml`
- Pages: `https://awiser.co/sitemap-pages.xml`

## Contact

- Platform operator: Valentin (individual; Awiser is not yet incorporated as of 2026)
- Feedback & bug reports: support@awiser.co