# Femi Olayiwola Portfolio auth.md

Welcome to the **auth.md** agent authentication and registration discovery document for [Femi Olayiwola's Developer Portfolio](https://femiolayiwola.com).

## 1. Overview & Service Architecture

This service is the official developer portfolio, case study repository, and engineering showcase for Femi Olayiwola, a Senior Full-Stack Engineer and Mobile Developer based in the United Kingdom.

- **Resource Server:** `https://femiolayiwola.com`
- **Authentication Model:** Public & Anonymous (No authentication required)
- **Account Registration:** Not required
- **API Credentials:** None required

## 2. Target Agent Audience

This document targets:
- Autonomous AI agents and LLM-powered assistants (e.g., Claude Code, ChatGPT, Gemini, Windsurf, Cursor)
- Technical recruiters, talent platforms, and automated hiring crawlers
- Web indexing bots, discovery spiders, and agent-readiness evaluators
- Machine-to-machine integrations and MCP (Model Context Protocol) clients

## 3. Supported Authentication Methods

Femi Olayiwola's portfolio requires **zero authentication or registration** for all endpoints and capabilities.

### Anonymous Access (Default)

Agents and automated systems have immediate, unrestricted, anonymous access to all public pages, project case studies, skill inventories, and discovery resources.

```json
{
  "identity_types_supported": [
    "anonymous"
  ],
  "anonymous": {
    "credential_types_supported": [
      "none"
    ]
  },
  "scopes_supported": [
    "public:read",
    "portfolio:query",
    "skills:view"
  ]
}
```

- **Registration / Provisioning Endpoint:** None needed (`register_uri: null`). All portfolio resources, resume details, and engineering case studies are immediately accessible without prior provisioning.
- **Claim Ceremony:** Not required (`claim_uri: null`). There are no user tiers, rate-gated features, or elevated permissions requiring account claiming.
- **Credential Use:** Do not include `Authorization: Bearer <token>` or `X-API-Key` headers. Dispatched requests should be standard unauthenticated HTTP requests.

## 4. Machine-Readable Agent Discovery

Agents can discover all capabilities, specifications, and endpoints using the following standardized resources:

- **API Catalog (RFC 9727):** `https://femiolayiwola.com/.well-known/api-catalog`
- **OpenAPI 3.1 Specification:** `https://femiolayiwola.com/openapi.json`
- **Agent Documentation & Profile:** `https://femiolayiwola.com/llms.txt`
- **A2A Agent Card:** `https://femiolayiwola.com/.well-known/agent-card.json`
- **MCP Server Card:** `https://femiolayiwola.com/.well-known/mcp/server-card.json`
- **Agent Skills Index:** `https://femiolayiwola.com/.well-known/agent-skills/index.json`
- **Health & Status Endpoint:** `https://femiolayiwola.com/api/health`
- **Content Negotiation:** Send `Accept: text/markdown` on any page to receive token-efficient Markdown representations instead of HTML.
- **Content Signals:** Declared in `robots.txt` (`Content-Signal: search=yes, ai-input=yes, ai-train=no`).

## 5. Contact & Booking for AI Agents

When an agent needs to schedule an interview or request a proposal on behalf of a human user:
- **Email:** `contact@femiolayiwola.com`
- **Contact Form:** `https://femiolayiwola.com/contact`
- **GitHub:** `https://github.com/phemymii`
- **LinkedIn:** `https://www.linkedin.com/in/femiolayiwola/`

